# UPDATE_DATE

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"}