UPDATE_MONTH

Declaration

UPDATE_MONTH(datetime, new_month) -> new_datetime

UPDATE_MONTH(date, new_month) -> new_date

Parameters

datetime (type: DateTime)

Any DateTime.

date (type: Date)

Any date.

new_month (required, type: Number)

The new month; this is the number that will replace whatever value is currently associated with the month in the given Date or DateTime.

Return Values

new_datetime (type: DateTime)

The DateTime that results from taking the given DateTime and replacing the month value with the given number.

new_date (type: Date)

The Date that results from taking the given Date and replacing the month value with the given number.

Examples

Assume the first example has access to the following DateTime value:

example_date_and_time = {
 "date": {
  "day": 1,
  "month": 4,
  "year": 2021
 },
 "time": {
  "hour": 16,
  "minute": 14,
  "second": 38,
  "millisecond": 0
 },
 "timeZone": "UTC"
}

The following example takes the date described in example_date_and_time and replaces the given month value (4) with 12. Note that the only difference between the output of this example and example_date_and_time is the the value of the month. When given a DateTime as input, UPDATE_MONTH returns a DateTime:

UPDATE_YEAR(example_date_and_time, 12) = {
 "date": {
  "day": 1,
  "month": 12,
  "year": 2021
 },
 "time": {
  "hour": 16,
  "minute": 14,
  "second": 38,
  "millisecond": 0
 },
 "timeZone": "UTC"
}

The above example demonstrates how the UPDATE_MONTH function behaves when given a DateTime as input. In order to further establish how the UPDATE_MONTH function behaves when given a Date as input, assume the last example has access to the following Date value:

example_date = {
 "day": 1,
 "month": 4,
 "year": 2021
}

The following example takes the date described in example_date and replaces the given month value (4) with 12. Note that the only difference between the output of this example and example_date is the the value of the month. When given a Date as input, UPDATE_MONTH outputs a Date:

UPDATE_YEAR(example_date, 12) = {
 "day": 1,
 "month": 12,
 "year": 2021
}