UPDATE_MINUTE UPDATE_MINUTE

UPDATE_MINUTE

Chandra Bergmann Chandra Bergmann

 

The function UPDATE_MINUTE changes the value of the minute in a Time or DateTime into another specified number.

This function takes two pieces of input: a Time or a DateTime, and a Number. It outputs the given Time or Datetime with the value of the minute replaced by the given number.

Declaration

UPDATE_MINUTE(datetime, new_minute) -> new_datetime
UPDATE_MINUTE(time, new_minute) -> new_time

 

Parameters

datetime (type: DateTime)
Any DateTime.
time (type: Time)
Any Time.
new_minute (required, type: Number)
The new minute; this is the number that will replace whatever value is currently associated with the minute in the given Time or DateTime.

Return Values

new_datetime (type: DateTime)
The DateTime that results from taking the given DateTime and replacing the minute value with the given number.
new_time (type: Time)
The Time that results from taking the given Time and replacing the minute 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 time described in example_date_and_time and replaces the given minute value (14) with 30. Note that the only difference between the output of this example and example_date_and_time is the the value of the minute. When given a DateTime as input, UPDATE_MINUTE returns a DateTime:

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

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

example_time = {
 "hour": 16,
"minute": 14,
"second": 38,
"millisecond": 0
}

The following example takes the time described in example_time and replaces the given minute value (14) with 30. Note that the only difference between the output of this example and example_time is the the value of the minute. When given a Time as input, UPDATE_MINUTE outputs a Time:

UPDATE_MINUTE(example_time, 2) = {
"hour": 16,
"minute": 30,
"second": 38,
"millisecond": 0
}

Was this article helpful?

0 out of 0 found this helpful