Skip to content

GetTodayAsync

Returns the current date in the specified time zone asynchronously.

1
myCalendar.GetTodayAsync(timeZone?: string):Promise<DateTimeOffset>

Parameters

string timeZone optional
    Specifies the target time zone for the current date in "hh:mm" format. Optional. If not specified, the system's timezone information is used.

Returns

A Promise that resolves to a new DateTimeOffset value representing the current date in the specified time zone.

Remarks

You may use the toISOString() method for comparisons in the XML database, such as:

Date comparison

1
2
3
4
5
$Calendar.GetTodayAsync().then(function(today) {
if ( $Xml.Evaluate('OldDate') < today.toISOString() ) {
// ...
}
});

Info

You can use the ,Calendar.GetDateTime, or ,Calendar.GetDateTimeAsync, methods as an alternative way to get relative date-time values.

Example

1
2
3
4
5
6
$Calendar.GetTodayAsync().then(function(date) {
$Xml.SetValue('Date1', date);
});
$Calendar.GetTodayAsync('02:00').then(function(date) {
$Xml.SetValue('Date2', date);
});

Result

1
2
<Date1>2017-01-25T16:04:40.5625645Z</Date1>
<Date2>2017-01-25T18:04:40.5625645+02:00</Date2>

See Also