GlideDateTime - スコープ指定
スコープ対象 GlideDateTime クラスは、GlideDateTime オブジェクトのインスタンス化や glide_date_time フィールドの操作など、GlideDateTime オブジェクトに対する操作を実行するためのメソッドを提供します。
GlideDateTime メソッドを使用して、GlideDateTime オブジェクトのインスタンス化、date-time 計算、date-time の書式設定、date-time 形式間の変換などの date-time の操作を実行します。
一般的な形式の競合のリストを含む日時入力文字列のガイダンスについては、「」を参照してください 日付と時刻の形式のガイドライン。
スコープ対象 GlideDateTime - GlideDateTime()
現在の日時で新しい GlideDateTime オブジェクトをインスタンス化します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
この例では、 GlideDateTime オブジェクトをインスタンス化します。
var gdt = new GlideDateTime();
gs.info(gdt);
出力:
2022-08-08 16:51:44
スコープ対象 GlideDateTime - GlideDateTime(文字列 value)
渡された日時の値を使用して新しい GlideDateTime オブジェクトをインスタンス化します。
- yyyy-MM-dd hh:mm:ss
- MM/dd/yyyy HH:mm:ss
- MM-dd-yyyy hh:mm:ss
- MM-dd-yyyy HH:mm
- MM-dd-yyyy
- MM/dd/yy HH:mm:ss
- MM/dd/yyyy
- dd-MM-yyyy hh:mm:ss
- dd-MM-yyyy HH.mm.ss
- dd-MM-yyyy HH.mm
- dd-MM-yy HH:mm:ss
- dd-MM-yy HH.mm.ss
- dd/MM/yyyy
- dd-MM-yyyy
- yyyy-MM-dd HH:mm
- yyyy-MM-dd
- dd.MM.yyyy HH:mm:ss
- dd.MM.yyyy HH.mm.ss
- dd.MM.yyyy hh:mm:ss a
- dd.MM.yyyy hh.mm.ss a
- dd.MM.yyyy
| 名前 | タイプ | 説明 |
|---|---|---|
| value | 文字列 | GlideDateTime オブジェクトで設定する UTC 日時。 |
var gdt = new GlideDateTime("2023-01-01 12:00:00");
gs.info(gdt);
出力:
2023-01-01 12:00:00
スコープ対象 GlideDateTime - GlideDateTime(GlideDateTime g)
指定された GlideDateTime オブジェクトの時刻に設定された新しい GlideDateTime オブジェクトをインスタンス化します。
| 名前 | タイプ | 説明 |
|---|---|---|
| g | GlideDateTime | 新しいオブジェクトの時間を設定するために使用されるオブジェクト。 |
この例では、yyyy-MM-dd'T'HH:mm:ss を使用して GlideDateTime オブジェクトをインスタンス化します。SSSZ 形式でエクスポートします。
var gdt1 = new GlideDateTime("2023-07-04T12:08:56.235-0700");
var gdt2 = new GlideDateTime(gdt1);
gs.info(gdt1);
gs.info(gdt2);
出力:
2023-07-04 19:08:56
2023-07-04 19:08:56
スコープ対象 GlideDateTime - add(GlideTime gd)
現在の GlideDateTime オブジェクトに GlideTime オブジェクトを加算します。
| 名前 | タイプ | 説明 |
|---|---|---|
| gd | GlideTime | 指定された GlideDateTime オブジェクトに時間値が加算される GlideTime オブジェクト。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
var gtime1 = new GlideTime();
gtime1.setValue("00:00:20");
gdt.add(gtime1);
var gtime2 = gdt.getTime();
gs.info(gtime2.getByFormat('hh:mm:ss'));
出力:
08:00:20
スコープ対象 GlideDateTime - add(数値 milliseconds)
指定されたミリ秒数を現在の GlideDateTime オブジェクトに加算します。
| 名前 | タイプ | 説明 |
|---|---|---|
| milliseconds | 数値 | 加算するミリ秒数。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getNumericValue());
gdt.add(10);
gs.info(gdt.getNumericValue());
1314777600000 1314777600010スコープ対象 GlideDateTime - addDaysLocalTime(数値 days)
指定された日数を現在の GlideDateTime オブジェクトに加算します。負のパラメーターは日数を減算します。このメソッドは、GlideDateTime オブジェクトに格納された値に相当する現地日時を判断してから、その現地日時の値を使用して日を加算または減算します。
| 名前 | タイプ | 説明 |
|---|---|---|
| days | 数値 | 加算する日数。減算する場合は負の値を使用します。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addDaysLocalTime(-1);
gs.info(gdt.getLocalDate());
出力:
2011-08-30
スコープ対象 GlideDateTime - addDaysUTC(数値 days)
指定された日数を現在の GlideDateTime オブジェクトに加算します。負のパラメーターは日数を減算します。このメソッドは、GlideDateTime オブジェクトに格納された値に相当する UTC 日時を判断してから、その UTC 日時の値を使用して日を加算または減算します。
| 名前 | タイプ | 説明 |
|---|---|---|
| days | 数値 | 加算する日数。減算する場合は負の数値を使用します。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addDaysUTC(-1);
gs.info(gdt.getDate());
出力:
2011-08-30
スコープ対象 GlideDateTime - addMonthsLocalTime(数値 months)
指定された月数を現在の GlideDateTime オブジェクトに加算します。負のパラメーターは月数を減算します。このメソッドは、GlideDateTime オブジェクトに格納された値に相当する現地日時を判断してから、その現地日時の値を使用して月を加算または減算します。
| 名前 | タイプ | 説明 |
|---|---|---|
| months | 数値 | 加算する月数。減算する場合には負の値を使用します。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addMonthsLocalTime(2);
gs.info(gdt.getDate());
出力:
2011-10-31
スコープ対象 GlideDateTime - addMonthsUTC(数値 months)
指定された月数を現在の GlideDateTime オブジェクトに加算します。負のパラメーターは月数を減算します。このメソッドは、GlideDateTime オブジェクトに格納された値に相当する UTC 日時を判断してから、その UTC 日時の値を使用して月を加算または減算します。
| 名前 | タイプ | 説明 |
|---|---|---|
| months | 数値 | 加算する月数。減算する場合は負の値を使用します。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addMonthsUTC(2);
gs.info(gdt.getDate());
出力:
2011-10-31
スコープ対象 GlideDateTime - addSeconds(数値 seconds)
指定された秒数を現在の GlideDateTime オブジェクトに加算します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 秒 | 数値 | 加算する秒数。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime("2011-12-07 08:00:00");
gdt.addSeconds(1000);
gs.info(gdt.getValue());
出力:
2011-12-07 08:16:40
スコープ対象 GlideDateTime - addWeeksLocalTime(数値 weeks)
指定された週数を現在の GlideDateTime オブジェクトに加算します。負のパラメーターは週数を減算します。このメソッドは、GlideDateTime オブジェクトに格納された値に相当する現地日時を判断してから、その現地日時の値を使用して週を加算または減算します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 週 | 数値 | 加算する週数。減算する場合は負の値を使用します。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addWeeksLocalTime(-1);
gs.info(gdt.getDate());
出力:
2011-08-24
スコープ対象 GlideDateTime - addWeeksUTC(数値 weeks)
指定された週数を現在の GlideDateTime オブジェクトに加算します。負のパラメーターは週数を減算します。このメソッドは、GlideDateTime オブジェクトに格納された値に相当する UTC 日時を判断してから、その UTC 日時の値を使用して週を加算または減算します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 週 | 数値 | 加算する週数。減算する場合は負の値を使用します。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addWeeksUTC(-1);
gs.info(gdt.getDate());
出力:
2011-08-24
スコープ対象 GlideDateTime - addYearsLocalTime(数値 years)
指定された年数を現在の GlideDateTime オブジェクトに加算します。負のパラメーターは年数を減算します。このメソッドは、GlideDateTime オブジェクトに格納された値に相当する現地日時を判断してから、その現地日時の値を使用して年を加算または減算します。
| 名前 | タイプ | 説明 |
|---|---|---|
| years | 数値 | 加算する年数。減算する場合は負の値を使用します。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime("2010-08-31 08:00:00");
gdt.addYearsLocalTime(1);
gs.info(gdt.getDate());
出力:
2011-08-31
スコープ対象 GlideDateTime - addYearsUTC(数値 years)
指定された年数を現在の GlideDateTime オブジェクトに加算します。負のパラメーターは年数を減算します。GlideDateTime オブジェクトに格納された日時の値は UTC タイムゾーンとして解釈されます。
| 名前 | タイプ | 説明 |
|---|---|---|
| years | 数値 | 加算する年数。減算する場合は負の値を使用します。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime("2010-08-31 08:00:00");
gdt.addYearsUTC(1);
gs.info(gdt.getDate());
出力:
2011-08-31
スコープ対象 GlideDateTime - after(GlideDateTime gdt)
GlideDateTime オブジェクトの日時が指定されたオブジェクトの日時より後かどうかを判断します。
| 名前 | タイプ | 説明 |
|---|---|---|
| gdt | GlideDateTime | チェックする日時。 |
| タイプ | 説明 |
|---|---|
| ブーリアン | GlideDateTime オブジェクトの日時がパラメーターで指定された日時より後であるかどうかを示すフラグ。 可能な値:
|
var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
gs.info(gdt1.after(gdt2));
出力:
False
スコープ対象 GlideDateTime - before(GlideDateTime gdt)
GlideDateTime オブジェクトの日時が指定された GlideDateTime オブジェクトの日時より前かどうかを判断します。
| 名前 | タイプ | 説明 |
|---|---|---|
| gdt | GlideDateTime | チェックする日時。 |
| タイプ | 説明 |
|---|---|
| ブーリアン | GlideDateTime オブジェクトの日時がパラメーターで指定された日時より前であるかどうかを示すフラグ。 可能な値:
|
var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
gs.info(gdt1.before(gdt2));
出力
true
スコープ対象 GlideDateTime - compareTo(オブジェクト o)
2 つの日時オブジェクトを比較して、これらが同じか、どちらかが前または後に発生したかどうかを判断します。
| 名前 | タイプ | 説明 |
|---|---|---|
| o | オブジェクト | GlideDateTime 形式での日時オブジェクト |
| タイプ | 説明 |
|---|---|
| 数値 |
|
var initDate = new GlideDateTime("2011-08-01 12:00:00");
var compDate1 = new GlideDateTime("2011-08-01 12:00:00");
var compDate2 = new GlideDateTime("2011-07-31 12:00:00");
var compDate3 = new GlideDateTime("2011-08-04 16:00:00");
gs.info(initDate.compareTo(compDate1)); // Equals (0)
gs.info(initDate.compareTo(compDate2)); // initDate is after compDate2 (1)
gs.info(initDate.compareTo(compDate3)); // initDate is before compDate3 (-1)
出力:
0
1
-1
スコープ対象 GlideDateTime - equals(オブジェクト dateTime)
datetime が既存の値と同じかどうかを比較します。
| 名前 | タイプ | 説明 |
|---|---|---|
| dateTime | GlideDateTime オブジェクトまたは文字列 | 比較する日時。 |
| タイプ | 説明 |
|---|---|
| ブーリアン | 同じ場合は true、異なる場合は false を返します。 |
var gdt = new GlideDateTime("2011-08-31 00:00:00");
gs.info(gdt.equals("2011-09-30 00:12:01"));
出力:
false
スコープ対象 GlideDateTime - getDate()
GlideDateTime オブジェクトに格納されている日付を返します。デフォルトでは、標準形式 yyyy-MM-dd、システムタイムゾーン、GMT で表されます。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 文字列 | システムタイムゾーンの日付。 |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getDate());
出力:
2011-08-31
スコープ対象 GlideDateTime - getDayOfMonthLocalTime()
GlideDateTime オブジェクトに格納された、現在のユーザーのタイムゾーンで表される日付を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 数値 | ユーザーのタイムゾーンでの 1 ~ 31 の日付。 |
var gdt = new GlideDateTime("2011-12-02 12:00:00");
gs.info(gdt.getDayOfMonthLocalTime());
出力:
2
スコープ対象 GlideDateTime - getDayOfMonthUTC()
GlideDateTime オブジェクトに格納された、UTC タイムゾーンで表される日付を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 数値 | UTC タイムゾーンでの 1 ~ 31 の日付。 |
var gdt = new GlideDateTime("2011-12-02 12:00:00");
gs.info(gdt.getDayOfMonthUTC());
出力:
02
スコープ対象 GlideDateTime - getDayOfWeekLocalTime()
GlideDateTime オブジェクトに格納された、ユーザーのタイムゾーンで表される曜日を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 数値 | ユーザーのタイムゾーンでの曜日の値 (1 ~ 7)。月曜日は 1、日曜日は 7 です。 |
var gdt = new GlideDateTime("2011-12-01 12:00:00");//Thursday
gs.info(gdt.getDayOfWeekLocalTime());
出力:
4
スコープ対象 GlideDateTime - getDayOfWeekUTC()
GlideDateTime オブジェクトに格納された、UTC タイムゾーンで表される曜日を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 数値 | 曜日の値 (1 ~ 7)。月曜日は 1、日曜日は 7 です。 |
var gdt = new GlideDateTime("2011-12-01 12:00:00");//Thursday
gs.info(gdt.getDayOfWeekLocalTime());
出力:
4
スコープ対象 GlideDateTime - getDaysInMonthLocalTime()
GlideDateTime オブジェクトに格納された、現在のユーザーのタイムゾーンで表される日数を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 数値 | ユーザーのタイムゾーンでの現在の月の日数。 |
var gdt = new GlideDateTime("2011-12-02 12:00:00"); //December
gs.info(gdt.getDaysInMonthLocalTime());
出力:
30
スコープ対象 GlideDateTime - getDaysInMonthUTC()
GlideDateTime オブジェクトに格納された、UTC タイムゾーンで表される日数を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 数値 | GlideDateTime オブジェクトに格納された、現在のユーザーの UTC タイムゾーンで表される日数。 |
var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
gs.info(gdt.getDaysInMonthUTC());
出力:
30
スコープ対象 GlideDateTime - getDisplayValue()
現在のユーザーの表示形式とタイムゾーンでの日時の値を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ |
|---|
| 文字列:ユーザーの形式とタイムゾーンでの日時。ビジネスルールまたはスクリプトインクルードを設計する際は、このメソッドによって返される値の形式がユーザーによって異なることに注意してください。 |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getDisplayValue()); //uses current user session time zone (US/Pacific)
出力:
2011-08-31 01:00:00
スコープ対象 GlideDateTime - getDisplayValueInternal()
内部形式 (yyyy-MM-dd HH:mm:ss) で表示値を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 文字列 | 現在のユーザーのタイムゾーンと内部の日時形式 yyyy-MM-dd HH:mm:ss での GlideDateTime オブジェクトに対する日時の値。 |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getDisplayValueInternal()); //uses current user session time zone (US/Pacific)
出力:
2011-08-31 01:00:00
スコープ対象 GlideDateTime - getDisplayValueLang(文字列スタイル, 文字列 language)
指定された言語と日付スタイルに従って、現在のユーザーのロケールで日時の値を返します。
| 名前 | タイプ | 説明 |
|---|---|---|
| style | 文字列 | 日付と時刻の形式を指定します。 有効な値:
他の値が渡された場合、API は既定で medium を使用します。受け入れられる値は大文字と小文字を区別しません。 |
| language | 文字列 | 指定された言語値に従って日付を返します。BCP-47 標準に準拠する言語タグを受け入れます。たとえば、フランス語の場合は fr 、イギリス英語の場合は en-UK です。受け入れられる値の完全な一覧については、「 BCP 47 言語コードの一覧」を参照してください。 |
| タイプ | 説明 |
|---|---|
| 文字列 | 現在のユーザーのロケールに適した形式での、指定されたスタイルでの日付の文字列表現。 |
次の例では、すべての言語と日付スタイルでユーザーのロケールの日付と時刻を返します。
var gdt = new GlideDateTime(); // This will fetch the current date
gs.info('date: ' + gdt.getDisplayValue());
gs.info('date: ' + gdt.getDisplayValueLang("full", "fr"));
gs.info('date: ' + gdt.getDisplayValueLang("long", "en-GB"));
gs.info('date: ' + gdt.getDisplayValueLang("medium", "de"));
gs.info('date: ' + gdt.getDisplayValueLang("short", "es-MX"));```
出力:
date: 2023-01-18 06:49:02
mercredi 18 janvier 2023 06:49:02
18 January 2023 06:49:02
18.01.2023 06:49:02
18/01/23 06:49:02
スコープ対象 GlideDateTime - getDSTOffset()
夏時間がオフセットである時間を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 数値 | 夏時間がオフセットの時間 (ミリ秒) 。オフセットがない場合、または夏時間でない場合は 0 を返します。 |
var gdt = new GlideDateTime("2014-08-31 08:00:00");
gs.info(gdt.getDSTOffset()); //uses current user session time zone (US/Pacific)
出力:
3600000
スコープ対象 GlideDateTime - getErrorMsg()
現在のエラーメッセージを取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 文字列 | エラーメッセージ。 |
var gdt = new GlideDateTime();
gdt.setDisplayValue("2011-aa-01 00:00:00");
gs.info(gdt.getErrorMsg());
出力:
Could not parse DateTime: 2011-aa-01 00:00:00
スコープ対象 GlideDateTime - getInternalFormattedLocalTime()
オブジェクトの時間をローカルタイムゾーンと内部形式で返します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 文字列 | ローカルタイムゾーンと内部形式でのオブジェクトの時間。 |
この例ではユーザーのタイムゾーンでシステム時間形式を表示しています。
var gdt = new GlideDateTime('2022-10-08 01:00:00');
gs.info(gdt.getDisplayValue());
gs.info(gdt.getInternalFormattedLocalTime());
出力
2022-10-07 06:00:00 PM
18:00:00
スコープ対象 GlideDateTime - getLocalDate()
GlideDateTime オブジェクトに格納された、標準形式 yyyy-MM-dd および現在のユーザーのタイムゾーンで表される日付を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | |
|---|---|
| GlideDate | ユーザーのタイムゾーンでの日付。 |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getLocalDate());
出力:
2011-08-31
スコープ対象 GlideDateTime - getLocalTime()
ユーザーのタイムゾーンでの GlideDateTime オブジェクトの時刻部を表す GlideTime オブジェクトを返します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| GlideTime | ユーザーのタイムゾーンでの時刻。 |
var gdt = new GlideDateTime("2014-08-31 08:00:00");
gt = gdt.getLocalTime();
gs.info("local time is " + gt.getByFormat('hh:mm:ss'));
出力:
local time is 01:00:00
スコープ対象 GlideDateTime - getMonthLocalTime()
GlideDateTime オブジェクトに格納された、現在のユーザーのタイムゾーンで表される月を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 数値 | 月の数値。 |
var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
gs.info(gdt.getMonthLocalTime());
出力:
11
スコープ対象 GlideDateTime - getMonthUTC()
GlideDateTime オブジェクトに格納された、UTC タイムゾーンで表される月を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 数値 | 月の数値。 |
var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
gs.info(gdt.getMonthUTC());
出力:
11
スコープ対象 GlideDateTime - getNumericValue()
1970 年 1 月 1 日 00:00:00 GMT 以降のミリ秒数を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 数値 | 1970 年 1 月 1 日 00:00:00 GMT 以降のミリ秒数。 |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getNumericValue());
出力:
1314777600000
スコープ対象 GlideDateTime - getTime()
GlideDateTime オブジェクトの時刻部を表す GlideTime オブジェクトを返します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| GlideTime | GMT 時間に基づいたシステム形式での Unix 期間スタンプ。 |
var gdt = new GlideDateTime("2014-08-31 08:00:00");
gt = gdt.getTime();
gs.info(gt.getByFormat('hh:mm:ss'));
出力:
08:00:00
スコープ対象 GlideDateTime - getTZOffset()
タイムゾーンオフセットをミリ秒で取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 数値 | タイムゾーンオフセットのミリ秒数。 |
var gdt = new GlideDateTime();
gdt.getLocalTime(); // PST local time
gs.info(gdt.getTZOffset());
出力:
-25200000
スコープ対象 GlideDateTime - getUserFormattedLocalTime()
オブジェクトの時間をローカルタイムゾーンとユーザーの形式で返します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 文字列 | ローカルタイムゾーンとユーザーの形式でのオブジェクトの時間。 |
この例は、ローカルタイムゾーンでのオブジェクトの時間を示しています。
var gdt = new GlideDateTime('2022-10-08 01:00:00');
gs.info(gdt.getDisplayValue());
gs.info(gdt.getUserFormattedLocalTime());
出力:
2022-10-07 06:00:00 PM
06:00:00 PM
スコープ対象 GlideDateTime - getValue()
GlideDateTime オブジェクトに格納された日時の値を、デフォルトで内部形式 yyyy-MM-dd HH:mm:ss、システムタイムゾーン、UTC で取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ |
|---|
| 文字列:内部形式とシステムタイムゾーンでの日時の値。 |
var gdt = new GlideDateTime("2014-08-31 08:00:00");
gs.info(gdt.getValue());
出力:
2014-08-31 08:00:00
スコープ対象 GlideDateTime - getWeekOfYearLocalTime()
GlideDateTime オブジェクトに格納された、現在のユーザーのタイムゾーンで表される週数を取得します。すべての週は日曜日に始まります。年の最初の週は元日が含まれる週です。2015 年 12 月 27 日日曜日から始まる週は、その週に 1 月 1 日と 2 日が含まれているため、2016 年の最初の週とみなされます。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ |
|---|
| 数値:現地時刻での現在の週数。1 年の週数は最大で 52 または 53 です。 |
var gdt = new GlideDateTime("2011-12-01 12:00:00");//49th week, 1st week in december
gs.info(gdt.getWeekOfYearLocalTime());
出力:
49
スコープ対象 GlideDateTime - getWeekOfYearUTC()
GlideDateTime オブジェクトに格納された、UTC タイムゾーンで表される週数を取得します。すべての週は日曜日に始まります。年の最初の週は元日が含まれる週です。2015 年 12 月 27 日日曜日から始まる週は、その週に 1 月 1 日と 2 日が含まれているため、2016 年の最初の週とみなされます。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ |
|---|
| 数値:UTC 時間での現在の週数。1 年の週数は最大で 52 または 53 です。 |
var gdt = new GlideDateTime("2011-12-01 12:00:00");//49th week, 1st week in december
gs.info(gdt.getWeekOfYearUTC());
出力:
49
スコープ対象 GlideDateTime - getYearLocalTime()
GlideDateTime オブジェクトに格納された、現在のユーザーのタイムゾーンで表される年を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| none |
| タイプ | 説明 |
|---|---|
| 数値 | ユーザーのタイムゾーンでの 4 桁の年の値。 |
var gdt = new GlideDateTime("2011-11-02 12:00:00");
gs.info(gdt.getYearLocalTime());
出力:
2011
スコープ対象 GlideDateTime - getYearUTC()
GlideDateTime オブジェクトに格納された、UTC タイムゾーンで表される年を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 数値 | UTC タイムゾーンでの 4 桁の年の値。 |
var gdt = new GlideDateTime("2011-11-02 12:00:00");
gs.info(gdt.getYearUTC());
出力:
2011
スコープ対象 GlideDateTime - hasDate()
オブジェクトの日付が設定されているかどうかを判断します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| ブーリアン | オブジェクトの日付が設定されている場合は true、設定されていない場合は false を返します。 |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.hasDate());
出力:
true
スコープ対象 GlideDateTime - isDST()
オブジェクトの時刻が夏時間オフセットを使用するかどうかを判断します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| ブーリアン | 時間が夏時間の場合は true、そうでない場合は false を返します。 |
var gdt = new GlideDateTime("2014-08-31 00:00:00");
gs.info(gdt.isDST()); //true
出力:
var gdt = new GlideDateTime("2014-08-31 00:00:00");
gs.info(gdt.isDST()); //true
スコープ対象 GlideDateTime - isValid()
値が有効な日時かどうかを判断します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| ブーリアン | 値が有効な場合は true、そうでない場合は false を返します。 |
var gdt = new GlideDateTime("2011-aa-31 aa:00:00");
gs.info(gdt.isValid()); //true
gs.info(gdt.getErrorMsg()); //reason
出力:
false
Invalid date time: '2011-aa-31 aa:00:00', ignored
スコープ対象 GlideDateTime - onOrAfter(GlideDateTime gdt)
GlideDateTime オブジェクトの日時が、指定された GlideDateTime オブジェクトの日時より後かどうかを判断します。
| 名前 | タイプ | 説明 |
|---|---|---|
| gdt | GlideDateTime | チェックする日時。 |
| タイプ | 説明 |
|---|---|
| ブーリアン | GlideDateTime オブジェクトの日時がパラメーターで指定された日時以降であるかどうかを示すフラグ。 可能な値:
|
var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
gs.info(gdt1.onOrAfter(gdt2));
出力
false
スコープ対象 GlideDateTime - onOrBefore(GlideDateTime gdt)
GlideDateTime オブジェクトの日時が、指定された GlideDateTime オブジェクトの日時以前かどうかを判断します。
| 名前 | タイプ | 説明 |
|---|---|---|
| gdt | GlideDateTime | チェックする日時。 |
| タイプ | 説明 |
|---|---|
| ブーリアン | GlideDateTime オブジェクトの日時がパラメーターで指定された日時以前であるかどうかを示すフラグ。 可能な値:
|
var gdt1 = new GlideDateTime("2016-05-09 10:11:12");
var gdt2 = new GlideDateTime("2017-06-12 15:11:12");
gs.info(gdt1.onOrBefore(gdt2));
出力
true
スコープ対象 GlideDateTime - setDayOfMonthLocalTime(数値 day)
日付を現在のユーザーのタイムゾーンで指定された値に設定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 日 | 数値 | 変更する日付 (1 ~ 31)。この値が月の最大日数より大きい場合、値はその月の最終日に設定されます。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime();
gdt.setDayOfMonthLocalTime(9);
gs.info(gdt.getDayOfMonthLocalTime());
出力:
9
スコープ対象 GlideDateTime - setDayOfMonthUTC(数値 day)
日付を UTC タイムゾーンで指定された値に設定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 日 | 数値 | 変更する日付 (1 ~ 31)。この値が月の最大日数より大きい場合、値はその月の最終日に設定されます。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime();
gdt.setDayOfMonthUTC(9);
gs.info(gdt.getDayOfMonthUTC());
出力:
9
スコープ対象 GlideDateTime - setDisplayValue(文字列 asDisplayed)
現在のユーザーの表示形式とタイムゾーンを使用して日時の値を設定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| asDisplayed | 文字列 | 現在のユーザーの表示形式とタイムゾーンでの日時。パラメーターは現在のユーザーの優先表示形式 (MM-dd-yyyy HH:mm:ss など) を使用して書式設定される必要があります。現在の日時をワークフロースクリプトの変数に割り当てるには、 変数 .setDisplayValue(gs.nowDateTime); を使用します。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime("2014-02-02 12:00:00");
gdt.setDisplayValue("2014-01-01 12:00:00");//uses current user session time zone (US/Pacific)
gs.info(gdt.getValue());
出力:
2014-01-01 20:00:00
スコープ対象 GlideDateTime - setDisplayValue(文字列 value, 文字列 format)
現在のユーザーのタイムゾーンと指定された日時の表示形式を使用して日時の値を設定します。
このメソッドは、value パラメーターで使用される日時の形式が format パラメーターと一致しない場合にランタイム例外をスローします。例外を取得した後、GlideDateTime オブジェクトで getErrorMsg() を呼び出し、エラーメッセージを取得できます。
| 名前 | タイプ | 説明 |
|---|---|---|
| value | 文字列 | 現在のユーザーのタイムゾーンでの日時。 |
| format | 文字列 | value パラメーターの解析に使用する日時形式。 value パラメーターを説明するには、次の値を使用します。
例:「dd-MM-yyyy HH:mm:ss」または「MM-dd-yyyy HH:mm」 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime("2011-02-02 12:00:00");
gdt.setDisplayValue("20-5-2011 12:00:00", "dd-MM-yyyy HH:mm:ss"); //uses current user session time zone
gs.info(gdt.getValue());
出力
"20-05-2011 12:00:00"
スコープ対象 GlideDateTime - setDisplayValueInternal(文字列 value)
内部形式 (yyyy-MM-dd HH:mm:ss) と現在のユーザーのタイムゾーンを使用して日時の値を設定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| value | 文字列 | 内部形式での日時。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime("2014-02-02 12:00:00");
gdt.setDisplayValueInternal("2014-01-01 12:00:00"); //uses current user session time zone (US/Pacific)
gs.info(gdt.getValue());
出力:
2014-01-01 20:00:00
スコープ対象 GlideDateTime - setDisplayValueLang(文字列 dateTime, 文字列 style)
現在のユーザーのロケールに基づいて、指定されたスタイルと形式を使用して日付と時刻を設定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| dateTime | 文字列 | 現在のユーザーのタイムゾーンでの GlideDate オブジェクトの日時値。有効な値は、 getDisplayValueLang() 関数からの任意の日時出力です。 たとえば、このトピックで前述した getDisplayValueLang(文字列スタイル, 文字列言語) の例からの出力を使用すると、2022 年 11 月 28 日 07:03:41 または 28.11.2022 07:03:41 が受け入れられます。 |
| style | 文字列 | 日付形式を指定します。 有効な値:
他の値が渡された場合、API は既定で medium を使用します。受け入れられる値は大文字と小文字を区別しません。 |
| タイプ | 説明 |
|---|---|
| なし |
次の例では、日付と時刻を短いスタイルと完全なスタイルで返します。
var glideDateFR = new GlideDateTime();
glideDateTime.setDisplayValueLang("2/3/2023 17:27:56", "short");
gs.info('date: ' + glideDateTime.getDisplayValue());
gs.info('date: ' + glideDateTime.getDisplayValueLang("full"));
出力:
date: 2023-02-03 17:27:56
date: Friday, February 3, 2023 17:27:56
スコープ対象 GlideDateTime - setDisplayValueLang(文字列 dateTime, 文字列 style, 文字列 language)
現在のユーザーのロケールに従って、指定されたスタイル、言語、および形式を使用して日付と時刻を設定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| dateTime | 文字列 | 現在のユーザーのタイムゾーンでの GlideDate オブジェクトの日時値。有効な値は、 getDisplayValueLang() 関数からの任意の日時出力です。 たとえば、このトピックで前述した getDisplayValueLang(文字列スタイル, 文字列言語) の例からの出力を使用すると、2022 年 11 月 28 日 07:03:41 または 28.11.2022 07:03:41 が受け入れられます。 |
| style | 文字列 | 日付形式を指定します。 有効な値:
他の値が渡された場合、API は既定で medium を使用します。受け入れられる値は大文字と小文字を区別しません。 |
| language | 文字列 | BCP-47 標準に準拠する言語タグを使用して言語を設定します。たとえば、フランス語の場合は fr 、イギリス英語の場合は en-UK です。受け入れられる値の完全な一覧については、「 BCP 47 言語コードの一覧」を参照してください。 |
| タイプ | 説明 |
|---|---|
| なし |
次の例では、英語とフランス語の短いスタイルと完全なスタイルで日付と時刻を返します。
var glideDateFR = new GlideDateTime();
glideDateUS.setDisplayValueLang("2/3/2023 18:00:00", "short", "en-US" );
glideDateFR.setDisplayValueLang("2/3/2023 18:00:00", "short", "fr-FR" );
gs.info('en-US date: ' + glideDateUS.getDisplayValue());
gs.info('en-US date: ' + glideDateUS.getDisplayValueLang("full"));
gs.info('fr-FR date: ' + glideDateFR.getDisplayValue());
gs.info('fr-FR date: ' + glideDateFR.getDisplayValueLang("full"));
出力:
en-US date: 2023-02-03 18:00:00
en-US date: Friday, February 3, 2023 18:00:00
fr-FR date: 2023-03-02 18:00:00
fr-FR date: Thursday, March 2, 2023 18:00:00
スコープ対象 GlideDateTime - setGlideDateTime(GlideDateTime g)
既存の GlideDateTime オブジェクトを使用して現在のオブジェクトの日時を設定します。このメソッドは、GlideDateTime パラメーターで新しいオブジェクトをインスタンス化することと同じです。
| 名前 | タイプ | 説明 |
|---|---|---|
| g | GlideDateTime | 日時値の設定に使用するオブジェクト。 |
| タイプ | 説明 |
|---|---|
| なし |
var dt1 = new GlideDateTime("2011-01-01 12:00:00");
var dt2 = new GlideDateTime("2011-02-02 08:00:00");
dt1.setGlideDateTime(dt2);
gs.info(dt1.getValue());
出力:
2011-02-02 08:00:00
スコープ対象 GlideDateTime - setMonthLocalTime(数値 month)
GlideDateTime オブジェクトに格納された月を現在のユーザーのタイムゾーンを使用して指定された値に設定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 月 | 数値 | 変更先の月。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime();
gdt.setMonthLocalTime(1);
gs.info(gdt.getMonthLocalTime());
出力:
1
スコープ対象 GlideDateTime - setMonthUTC(数値 month)
GlideDateTime オブジェクトに格納された月を UTC タイムゾーンを使用して指定された値に設定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 月 | 数値 | 変更先の月。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime();
gdt.setMonthUTC(1);
gs.info(gdt.getMonthUTC());
出力:
1
スコープ対象 GlideDateTime - setValue(文字列 o)
GlideDateTime オブジェクトの日時を設定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| o | 文字列 | 使用する日時。このパラメーターは次のいずれかの 1 つのタイプです。
|
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime("2011-01-01 12:00:00");
gdt.setValue("2011-02-02 08:00:00"); // value set = 2011-02-02 08:00:00
gs.info(gdt.getValue());
出力:
2011-02-02 08:00:00
スコープ対象 GlideDateTime - setValueUTC(文字列 dt, 文字列 format)
UTC タイムゾーンと指定された日時の表示形式を使用して日時の値を設定します。このメソッドは、dt パラメーターで使用される日時の形式が format パラメーターと一致しない場合にランタイム例外をスローします。例外を取得した後、GlideDateTime オブジェクトで getErrorMsg() を呼び出し、エラーメッセージを取得できます。
| 名前 | タイプ | 説明 |
|---|---|---|
| dt | 文字列 | 使用する日時。 |
| format | 文字列 | 使用する日時形式。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime("2011-01-01 12:00:00");
gdt.setValueUTC("15-02-2011 08:00:00", "dd-MM-yyyy HH:mm:ss");
gs.info(gdt.getValue());
出力:
2011-02-15 08:00:00
スコープ対象 GlideDateTime - setYearLocalTime(数値 year)
GlideDateTime オブジェクトに格納された年を現在のユーザーのタイムゾーンを使用して指定された値に設定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| year | 数値 | 変更先の年。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime();
gdt.setYearLocalTime(2013);
gs.info(gdt.getYearLocalTime());
出力:
2013
スコープ対象 GlideDateTime - setYearUTC(数値 year)
GlideDateTime オブジェクトに格納された年を UTC タイムゾーンを使用して指定された値に設定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| year | 数値 | 変更先の年。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime();
gdt.setYearUTC(2013);
gs.info(gdt.getYearUTC());
出力:
2013
スコープ対象 GlideDateTime - subtract(GlideTime time)
指定された時間を現在の GlideDateTime オブジェクトから減算します。
| 名前 | タイプ | 説明 |
|---|---|---|
| time | GlideTime | 減算する時間値。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
var gtime1 = new GlideTime();
gtime1.setValue("00:00:20");
gdt.subtract(gtime1);
var gtime2 = gdt.getTime();
gs.info(gtime2.getByFormat('hh:mm:ss'));
出力:
07:59:40
スコープ対象 GlideDateTime - subtract(数値 milliseconds)
指定されたミリ秒の数を GlideDateTime オブジェクトから減算します。
| 名前 | タイプ | 説明 |
|---|---|---|
| milliseconds | 数値 | 減算するミリ秒数。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime("2011-12-07 08:00:00");
gdt.subtract(1000);
gs.info(gdt.getValue());
出力:
2011-12-07 07:59:59
スコープ対象 GlideDateTime - subtract(GlideDateTime start, GlideDateTime end)
指定された 2 つの GlideDateTime オブジェクト間の期間差を返します。
| 名前 | タイプ | 説明 |
|---|---|---|
| Start | GlideDateTime | 開始日オブジェクト。 |
| End | GlideDateTime | 終了日オブジェクト。 |
| タイプ | 説明 |
|---|---|
| GlideDuration | 指定された 2 つの日付間の期間差。 |
var gdt1 = new GlideDateTime("2011-08-28 09:00:00");
var gdt2 = new GlideDateTime("2011-08-31 08:00:00");
var dur = GlideDateTime.subtract(gdt1, gdt2); //the difference between gdt1 and gdt2
gs.info(dur.getDisplayValue());
出力:
2 Days 23 Hours
スコープ対象 GlideDateTime - toString()
GlideDateTime オブジェクトに格納された日時の値を、デフォルトで内部形式 yyyy-MM-dd HH:mm:ss、システムタイムゾーン、UTC で取得します。このメソッドは getValue() と同じです。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | |
|---|---|
| 文字列 | システムタイムゾーンと形式での GlideDateTime オブジェクトに格納された日時。 |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.toString());
出力:
2011-08-31 08:00:00