UPDATE_DATE UPDATE_DATE

UPDATE_DATE

Chandra Bergmann Chandra Bergmann

The function UPDATE_DATE replaces the date described by a DateTime with another specified Date.

This function takes two pieces of input: a base DateTime, and a Date. It outputs a DateTime: the base DateTime but with the date replaced by the information given by the input Date.

Declaration

UPDATE_DATE(base_datetime, new_date) -> new_datetime

 

Parameters

base_datetime (type: DateTime)
Any DateTime.
new_date (type: Date)
Any Date.
This is what will replace the date information in the given DateTime.

Return Values

new_datetime (type: DateTime)
The DateTime that results from taking the base DateTime and replacing the date with the one given by new_date.

Examples

Assume the example has access to the following DateTime and Date values:

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

example_date = {
"day": 2
"month": 1
"year" : 2022
}

The following example takes the DateTime example_date_and_time, which describes a time on April 1st 2020, and replaces the date with the information given by example_date, which describes the date January 2nd, 2022. Note that the resulting DateTime describes the same time, in the same timezone, as did example_date_and_time. Only the date has changed:

UPDATE_DATE(example_date_and_time, example_date) = {
"date": {
"day": 2,
"month": 1,
"year": 2022
},
"time": {
"hour": 16,
"minute": 14,
"second": 38,
"millisecond": 0
},
"timeZone": "UTC"
}

 

Was this article helpful?

0 out of 0 found this helpful