GlideDateTime - スコープ指定

スコープ対象 GlideDateTime:GlideDateTime()

現在の日付と時刻で新しい GlideDateTime オブジェクトをインスタンス化します。

表 : 1. パラメーター
名前	タイプ	説明
なし

この例では、 GlideDateTime オブジェクトをインスタンス化します。

var gdt = new GlideDateTime();
gs.info(gdt);

出力:

2022-08-08 16:51:44

スコープ対象 GlideDateTime:GlideDateTime(文字列値)

渡された日付と時刻の値を使用して、新しい 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/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/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
dd.MM.yyyy

注:

次の形式はサポートされていません。

yyyy-MM-dd'T'HH:mm:ss。SSSZ

表 : 2. パラメーター
名前	タイプ	説明
value	文字列	GlideDateTime オブジェクトに設定する UTC 日時。

この例では、文字列を使用して GlideDateTime オブジェクトをインスタンス化する方法を示します。

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 オブジェクトをインスタンス化します。

表 : 3. パラメーター
名前	タイプ	説明
g	GlideDateTime	新しいオブジェクトの時刻を設定するために使用されるオブジェクト。

この例では、yyyy-MM-dd HH:mm:ss 形式の文字列を使用して GlideDateTime オブジェクト (gdt1) をインスタンス化し、gdt1 を使用して 2 番目の GlideDateTime オブジェクト (gdt2) をインスタンス化する方法を示します。

var gdt1 = new GlideDateTime("2025-01-28 12:00:00"); // GlideDateTime(String g)
var gdt2 = new GlideDateTime(gdt1); // GlideDateTime(GlideDateTime g)
gs.info(gdt1);
gs.info(gdt2);

出力：

2025-01-28 12:00:00
2025-01-28 12:00:00

スコープ指定 GlideDateTime - add(GlideTime gd)

現在の GlideDateTime オブジェクトに GlideTime オブジェクトを追加します。

表 : 4. パラメーター
名前	タイプ	説明
gd	GlideTime	指定された GlideDateTime オブジェクトに時間値を追加する GlideTime オブジェクト。

表 : 5. 返される内容
タイプ	説明
なし

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(Number milliseconds)

指定されたミリ秒数を現在の GlideDateTime オブジェクトに追加します。

表 : 6. パラメーター
名前	タイプ	説明
ミリ秒	番号	加算するミリ秒数。

表 : 7. 返される内容
タイプ	説明
なし

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(日数)

指定された日数を現在の GlideDateTime オブジェクトに追加します。負のパラメーターは日数を減算します。このメソッドは、GlideDateTime オブジェクトによって格納された値に相当する現地の日時を決定し、その現地の日時の値を使用して日数を加算または減算します。

表 : 8. パラメーター
名前	タイプ	説明
days	番号	追加する日数。減算するには負の値を使用します。

表 : 9. 返される内容
タイプ	説明
なし

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addDaysLocalTime(-1);
gs.info(gdt.getLocalDate());

出力:

2011-08-30

スコープ対象 GlideDateTime - addDaysUTC(日数)

指定された日数を現在の GlideDateTime オブジェクトに追加します。負のパラメーターは日数を減算します。このメソッドは、GlideDateTime オブジェクトによって格納された値に相当する UTC 日時を決定し、UTC 日付と時刻の値を使用して日数を加算または減算します。

表 : 10. パラメーター
名前	タイプ	説明
days	番号	追加する日数。減算するには負の数を使用します。

表 : 11. 返される内容
タイプ	説明
なし

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addDaysUTC(-1);
gs.info(gdt.getDate());

出力:

 2011-08-30

スコープ対象 GlideDateTime - addMonthsLocalTime(数値、月数)

現在の GlideDateTime オブジェクトに指定された月数を追加します。負のパラメーターは月を減算します。このメソッドは、GlideDateTime オブジェクトによって格納された値と同等の現地日時を決定し、現地の日付と時刻の値を使用して月を加算または減算します。

表 : 12. パラメーター
名前	タイプ	説明
月	番号	加算する月数。減算するには負の値を使用します。

表 : 13. 返される内容
タイプ	説明
なし

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addMonthsLocalTime(2);
gs.info(gdt.getDate());

出力:

2011-10-31

スコープ対象 GlideDateTime - addMonthsUTC(月数)

現在の GlideDateTime オブジェクトに指定された月数を追加します。負のパラメーターは月を減算します。このメソッドは、GlideDateTime オブジェクトによって格納された値と同等の UTC 日時を決定し、UTC の日付と時刻の値を使用して月を加算または減算します。

表 : 14. パラメーター
名前	タイプ	説明
月	番号	追加する月数。減算するには負の値を使用します。

表 : 15. 返される内容
タイプ	説明
なし

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addMonthsUTC(2);
gs.info(gdt.getDate());

出力:

2011-10-31

スコープ済み GlideDateTime - addSeconds(Number seconds)

指定された秒数を現在の GlideDateTime オブジェクトに追加します。

表 : 16. パラメーター
名前	タイプ	説明
秒	番号	追加する秒数。

表 : 17. 返される内容
タイプ	説明
なし

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(週数)

指定された週数を現在の GlideDateTime オブジェクトに追加します。負のパラメーターは週を減算します。このメソッドは、GlideDateTime オブジェクトによって格納された値と同等の現地日時を決定し、現地の日付と時刻の値を使用して週を加算または減算します。

表 : 18. パラメーター
名前	タイプ	説明
週	番号	追加する週数。減算するには負の値を使用します。

表 : 19. 返される内容
タイプ	説明
なし

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addWeeksLocalTime(-1);
gs.info(gdt.getDate());

出力:

2011-08-24

スコープ対象 GlideDateTime - addWeeksUTC(週数)

指定された週数を現在の GlideDateTime オブジェクトに追加します。負のパラメーターは週を減算します。このメソッドは、GlideDateTime オブジェクトによって格納された値と同等の UTC 日時を決定し、UTC 日付と時刻の値を使用して週を加算または減算します。

表 : 20. パラメーター
名前	タイプ	説明
週	番号	追加する週数。減算するには負の値を使用します。

表 : 21. 返される内容
タイプ	説明
なし

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addWeeksUTC(-1);
gs.info(gdt.getDate());

出力:

2011-08-24

スコープ対象 GlideDateTime - addYearsLocalTime(年数)

現在の GlideDateTime オブジェクトに指定された年数を追加します。負のパラメーターは年を減算します。このメソッドは、GlideDateTime オブジェクトによって格納された値と同等の現地日時を決定し、現地の日付と時刻の値を使用して年を加算または減算します。

表 : 22. パラメーター
名前	タイプ	説明
年	番号	追加する年数。減算するには負の値を使用します。

表 : 23. 返される内容
タイプ	説明
なし

var gdt = new GlideDateTime("2010-08-31 08:00:00");
gdt.addYearsLocalTime(1);
gs.info(gdt.getDate());

出力:

2011-08-31

スコープ対象 GlideDateTime - addYearsUTC(年数)

現在の GlideDateTime オブジェクトに指定された年数を追加します。負のパラメーターは年を減算します。GlideDateTime オブジェクトによって格納された日付と時刻の値は、UTC タイムゾーンであるものとして解釈されます。

表 : 24. パラメーター
名前	タイプ	説明
年	番号	追加する年数。減算するには負の値を使用します。

表 : 25. 返される内容
タイプ	説明
なし

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 オブジェクトの日時が、指定されたオブジェクトの日時より後であるかどうかを判定します。

表 : 26. パラメーター
名前	タイプ	説明
GDT	GlideDateTime	チェック対象の日時。

表 : 27. 返される内容
タイプ	説明
ブーリアン	GlideDateTime オブジェクトの日時がパラメーターで指定された日時より後であるかどうかを示すフラグ。可能な値： true:GlideDateTime オブジェクトの日時は、指定されたオブジェクトの日時より後です。 false: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 オブジェクトの日時より前であるかどうかを判定します。

表 : 28. パラメーター
名前	タイプ	説明
GDT	GlideDateTime	チェック対象の日時。

表 : 29. 返される内容
タイプ	説明
ブーリアン	GlideDateTime オブジェクトの日時がパラメーターで指定された日時より前であるかどうかを示すフラグ。可能な値： true:GlideDateTime オブジェクトの日時が指定された日時より前です。 false: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(Object o)

2 つの日付と時刻のオブジェクトを比較して、それらが等価であるか、一方が他方の前または後に発生するかを判断します。

表 : 30. パラメーター
名前	タイプ	説明
o	オブジェクト	GlideDateTime 形式の日時オブジェクト

表 : 31. 返される内容
タイプ	説明
番号	0 = 日付が等しい 1 = オブジェクトの日付がパラメーターで指定された日付より後である -1 = オブジェクトの日付がパラメーターで指定された日付より前です

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)

等価性について日時を既存の値と比較します。

表 : 32. パラメーター
名前	タイプ	説明
日時	GlideDateTime オブジェクトまたは文字列	比較する日時。

表 : 33. 返される内容
タイプ	説明
ブーリアン	それらが等しい場合は 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 で表されます。

表 : 34. パラメーター
名前	タイプ	説明
なし

表 : 35. 返される内容
タイプ	説明
オブジェクト	システムタイムゾーンの日付。

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getDate());

出力:

2011-08-31

スコープ付き GlideDateTime - getDayOfMonthLocalTime()

GlideDateTime オブジェクトによって保存され、現在のユーザーのタイムゾーンで表される月の日付を取得します。

表 : 36. パラメーター
名前	タイプ	説明
なし

表 : 37. 返される内容
タイプ	説明
番号	ユーザーのタイムゾーンの日付 (1 〜 31)。

var gdt = new GlideDateTime("2011-12-02 12:00:00");
gs.info(gdt.getDayOfMonthLocalTime());

出力:

スコープ対象 GlideDateTime - getDayOfMonthUTC()

GlideDateTime オブジェクトによって格納され、UTC タイムゾーンで表される月の日付を取得します。

表 : 38. パラメーター
名前	タイプ	説明
なし

表 : 39. 返される内容
タイプ	説明
番号	UTC タイムゾーンの日付 (1 〜 31)。

var gdt = new GlideDateTime("2011-12-02 12:00:00");
gs.info(gdt.getDayOfMonthUTC());

出力:

スコープ付き GlideDateTime:getDayOfWeekLocalTime()

GlideDateTime オブジェクトによって保存され、ユーザーのタイムゾーンで表される曜日を取得します。

表 : 40. パラメーター
名前	タイプ	説明
なし

表 : 41. 返される内容
タイプ	説明
番号	ユーザーのタイムゾーンでの 1 〜 7 の曜日の値。月曜日は 1、日曜日は 7 です。

var gdt = new GlideDateTime("2011-12-01 12:00:00");//Thursday
gs.info(gdt.getDayOfWeekLocalTime());

出力:

スコープ付き GlideDateTime - getDayOfWeekUTC()

GlideDateTime オブジェクトによって格納され、UTC タイムゾーンで表される曜日を返します。

表 : 42. パラメーター
名前	タイプ	説明
なし

表 : 43. 返される内容
タイプ	説明
番号	1 から 7 までの曜日の値。月曜日は 1、日曜日は 7 です。

var gdt = new GlideDateTime("2011-12-01 12:00:00"); //Thursday
gs.info(gdt.getDayOfWeekUTC());

出力:

スコープ付き GlideDateTime - getDaysInMonthLocalTime()

GlideDateTime オブジェクトによって保存され、現在のユーザーのタイムゾーンで表される月の日数を取得します。

表 : 44. パラメーター
名前	タイプ	説明
なし

表 : 45. 返される内容
タイプ	説明
番号	ユーザーのタイムゾーンの現在の月の日数。

var gdt = new GlideDateTime("2011-12-02 12:00:00"); //December
gs.info(gdt.getDaysInMonthLocalTime());

出力:

スコープ対象 GlideDateTime - getDaysInMonthUTC()

GlideDateTime オブジェクトによって格納され、UTC タイムゾーンで表される月の日数を取得します。

表 : 46. パラメーター
名前	タイプ	説明
なし

表 : 47. 返される内容
タイプ	説明
番号	GlideDateTime オブジェクトによって格納される月の日数。UTC タイムゾーンで表されます。

var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
gs.info(gdt.getDaysInMonthUTC());

出力:

スコープ付き GlideDateTime - getDisplayValue()

現在のユーザーの表示形式とタイムゾーンで日付と時刻の値を取得します。

表 : 48. パラメーター
名前	タイプ	説明
なし

表 : 49. 返される内容
タイプ	説明
文字列	ユーザーの形式とタイムゾーンの日時。ビジネスルールまたはスクリプトインクルードを設計するときは、このメソッドがユーザーごとに異なる形式で値を返す場合があることに注意してください。

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) で表示値を取得します。

表 : 50. パラメーター
名前	タイプ	説明
なし

表 : 51. 返される内容
タイプ	説明
文字列	現在のユーザーのタイムゾーンの GlideDateTime オブジェクトの日付と時刻の値と、 `yyyy-MM-dd HH:mm:ss` の内部日付と時刻の形式。

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(String style, String language)

指定された言語と日付スタイルに従って、現在のユーザーのロケールで日付と時刻の値を返します。

表 : 52. パラメーター
名前	タイプ	説明
style	文字列	日付と時刻の形式を指定します。有効な値： FULL:ユーザーのロケール (2022 年 10 月 24 日月曜日など) に応じて、<平日、月、日、年> の形式で日付を返します。 long:ユーザーのロケール (2022 年 10 月 24 日など) に応じて、日付を <月、日、年>の形式で返します。 medium: long と似ていますが、月を省略した日付を返します (例:2022 年 10 月 24 日)。 short:ユーザーのロケール (10/24/2022 または 24/10/2022 など) に応じて、MM/DD/YY または DD/MM/YY の形式で日付を返します。他の値が渡された場合、API はデフォルトで `中程度`を使用します。許可される値では大文字と小文字は区別されません。
言語	文字列	指定された言語値に従って日付を返します。BCP-47 標準に準拠する言語タグを受け入れます。たとえば、フランス語の場合は `fr` 、イギリス英語の場合は `en-UK` です。許可される値の完全なリストについては、「 BCP 47 言語コードリスト」を参照してください。

表 : 53. 返される内容
タイプ	説明
文字列	指定されたスタイルで、現在のユーザーのロケールに適した形式での日付の文字列表現。

次の例は、すべての言語と日付スタイルでユーザーのロケールの日時を返します。

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()

夏時間がオフセットされる時間を取得します。

表 : 54. パラメーター
名前	タイプ	説明
なし

表 : 55. 返される内容
タイプ	説明
番号	夏時間がオフセットされる時間 (ミリ秒)。オフセットがない場合、または時刻が夏時間でない場合は 0 を返します。

var gdt = new GlideDateTime("2014-08-31 08:00:00"); 
gs.info(gdt.getDSTOffset()); //uses current user session time zone (US/Pacific)

出力:

スコープ付き GlideDateTime - getErrorMsg()

現在のエラーメッセージを取得します。

表 : 56. パラメーター
名前	タイプ	説明
なし

表 : 57. 返される内容
タイプ	説明
オブジェクト	エラーメッセージ。

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()

オブジェクトの時刻をローカルタイムゾーンで内部形式で返します。

表 : 58. パラメーター
名前	タイプ	説明
なし

表 : 59. 返される内容
タイプ	説明
文字列	ローカルのタイムゾーンと内部形式でのオブジェクトの時間。

この例では、ユーザーのタイムゾーンのシステム時間形式で時間を表示します。

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()

標準形式 yyyy-MM-dd で表される GlideDateTime オブジェクトによって格納されている日付と、現在のユーザーのタイムゾーンを取得します。

表 : 60. パラメーター
名前	タイプ	説明
なし

表 : 61. 返される内容
タイプ
GlideDate	ユーザーのタイムゾーンの日付。

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getLocalDate());

出力:

2011-08-31

スコープ付き GlideDateTime - getLocalTime()

ユーザーのタイムゾーンの GlideDateTime オブジェクトの時間部分を表す GlideTime オブジェクトを返します。

表 : 62. パラメーター
名前	タイプ	説明
なし

表 : 63. 返される内容
タイプ	説明
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 オブジェクトによって格納され、現在のユーザーのタイムゾーンで表される月を取得します。

表 : 64. パラメーター
名前	タイプ	説明
なし

表 : 65. 返される内容
タイプ	説明
番号	月の数値。

var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
gs.info(gdt.getMonthLocalTime());

出力:

スコープ付き GlideDateTime - getMonthUTC()

GlideDateTime オブジェクトによって格納され、UTC タイムゾーンで表される月を取得します。

表 : 66. パラメーター
名前	タイプ	説明
なし

表 : 67. 返される内容
タイプ	説明
番号	月の数値。

var gdt = new GlideDateTime("2011-11-02 12:00:00"); //November
gs.info(gdt.getMonthUTC());

出力:

スコープ付き GlideDateTime - getNumericValue()

1970 年 1 月 1 日 00:00:00 GMT からのミリ秒数を取得します。

表 : 68. パラメーター
名前	タイプ	説明
なし

表 : 69. 返される内容
タイプ	説明
番号	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 オブジェクトを返します。

表 : 70. パラメーター
名前	タイプ	説明
なし

表 : 71. 返される内容
タイプ	説明
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()

タイムゾーンオフセットをミリ秒単位で取得します。

表 : 72. パラメーター
名前	タイプ	説明
なし

表 : 73. 返される内容
タイプ	説明
番号	タイムゾーンオフセットのミリ秒数。

var gdt = new GlideDateTime();
gdt.getLocalTime(); // PST local time
gs.info(gdt.getTZOffset());

出力:

-25200000

スコープ指定 GlideDateTime - getUserFormattedLocalTime()

オブジェクトの時刻をローカルのタイムゾーンでユーザーの形式で返します。

表 : 74. パラメーター
名前	タイプ	説明
なし

表 : 75. 返される内容
タイプ	説明
文字列	ローカルタイムゾーンおよびユーザーの形式でのオブジェクトの時間。

この例は、ローカルタイムゾーンでのオブジェクトの時間を示しています。

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 タイムゾーンで返します。

表 : 76. パラメーター
名前	タイプ	説明
なし

表 : 77. 返される内容
タイプ	説明
文字列	内部形式とシステムタイムゾーンの日時。形式: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 オブジェクトによって保存され、現在のユーザーのタイムゾーンで表される週の番号を取得します。

すべての週は日曜日に始まります。年の最初の週は、新年の少なくとも 1 日を含む週です。2015 年 12 月 27 日(日曜日)から始まる週は、その週に 1 月 1 日と 2 日があるため、2016 年の第 1 週と見なされます。

表 : 78. パラメーター
名前	タイプ	説明
なし

表 : 79. 返される内容
タイプ	説明
番号	現在の週の番号。1 年間で最高の週数は 52 または 53 です。

var gdt = new GlideDateTime("2011-12-01 12:00:00");//49th week, 1st week in december 
gs.info(gdt.getWeekOfYearLocalTime());

出力:

スコープ対象 GlideDateTime - getWeekOfYearUTC()

GlideDateTime オブジェクトによって格納され、UTC タイムゾーンで表される週の数を取得します。

すべての週は日曜日に始まります。年の最初の週は、新年の少なくとも 1 日を含む週です。2015 年 12 月 27 日(日曜日)から始まる週は、その週に 1 月 1 日と 2 日があるため、2016 年の第 1 週と見なされます。

表 : 80. パラメーター
名前	タイプ	説明
なし

表 : 81. 返される内容
タイプ	説明
番号	UTC 時間での現在の週の数。1 年間で最高の週数は 52 または 53 です。

var gdt = new GlideDateTime("2011-12-01 12:00:00");//49th week, 1st week in December 
gs.info(gdt.getWeekOfYearUTC());

出力:

スコープ対象 GlideDateTime - getYearLocalTime()

GlideDateTime オブジェクトによって格納され、現在のユーザーのタイムゾーンで表される年を取得します。

表 : 82. パラメーター
名前	タイプ	説明
なし

表 : 83. 返される内容
タイプ	説明
番号	ユーザーのタイムゾーンの 4 桁の年値。

var gdt = new GlideDateTime("2011-11-02 12:00:00");
gs.info(gdt.getYearLocalTime());

出力:

スコープ対象 GlideDateTime - getYearUTC()

GlideDateTime オブジェクトによって格納され、UTC タイムゾーンで表される年を取得します。

表 : 84. パラメーター
名前	タイプ	説明
なし

表 : 85. 返される内容
タイプ	説明
番号	UTC タイムゾーンの 4 桁の年値。

var gdt = new GlideDateTime("2011-11-02 12:00:00"); 
gs.info(gdt.getYearUTC());

出力:

スコープ対象 GlideDateTime - hasDate()

オブジェクトの日付が設定されているかどうかを決定します。

表 : 86. パラメーター
名前	タイプ	説明
なし

表 : 87. 返される内容
タイプ	説明
ブーリアン	オブジェクトの日付が設定されている場合は True。それ以外の場合は false を返します。

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.hasDate());

出力:

true

スコープ付き GlideDateTime - isDST()

オブジェクトの時間が夏時間オフセットを使用するかどうかを決定します。

表 : 88. パラメーター
名前	タイプ	説明
なし

表 : 89. 返される内容
タイプ	説明
ブーリアン	時刻が夏時間の場合は 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()

値が有効な日時かどうかを判定します。

表 : 90. パラメーター
名前	タイプ	説明
なし

表 : 91. 返される内容
タイプ	説明
ブーリアン	値が有効な場合は 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 オブジェクトの日時以降に発生するかどうかを判定します。

表 : 92. パラメーター
名前	タイプ	説明
GDT	GlideDateTime	チェック対象の日時。

表 : 93. 返される内容
タイプ	説明
ブーリアン	GlideDateTime オブジェクトの日時が、パラメーターで指定された日時以降であるかどうかを示すフラグ。可能な値： true:GlideDateTime オブジェクトの日時は、指定されたオブジェクトの日時以降です。 false: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 オブジェクトの日時以前にあるかどうかを判別します。

表 : 94. パラメーター
名前	タイプ	説明
GDT	GlideDateTime	チェック対象の日時。

表 : 95. 返される内容
タイプ	説明
ブーリアン	GlideDateTime オブジェクトの日時がパラメーターで指定された日時と同じかそれより前であるかどうかを示すフラグ。可能な値： true:GlideDateTime オブジェクトの日時は、指定されたオブジェクトの日時以前です。 false: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(日数)

現在のユーザーのタイムゾーンで指定された値に日付を設定します。

表 : 96. パラメーター
名前	タイプ	説明
日	番号	1 から 31 に変更する月の日付。この値が月の最大日数より大きい場合、値はその月の最終日に設定されます。

表 : 97. 返される内容
タイプ	説明
なし

var gdt = new GlideDateTime();
gdt.setDayOfMonthLocalTime(9);
gs.info(gdt.getDayOfMonthLocalTime());

出力:

スコープ対象 GlideDateTime - setDayOfMonthUTC(日数)

月の日を UTC タイムゾーンの指定された値に設定します。

表 : 98. パラメーター
名前	タイプ	説明
日	番号	1 から 31 に変更する月の日付。この値が月の最大日数より大きい場合、値はその月の最終日に設定されます。

表 : 99. 返される内容
タイプ	説明
なし

var gdt = new GlideDateTime();
gdt.setDayOfMonthUTC(9);
gs.info(gdt.getDayOfMonthUTC());

出力:

スコープ対象 GlideDateTime:setDisplayValue(文字列 asDisplayed)

現在のユーザーの表示形式とタイムゾーンを使用して日付と時刻の値を設定します。

表 : 100. パラメーター
名前	タイプ	説明
asDisplayed	文字列	現在のユーザーの表示形式とタイムゾーンの日付と時刻。このパラメーターは、MM-dd-yyyy HH:mm:ss など、現在のユーザーの優先表示形式を使用して書式設定する必要があります。現在の日付と時刻をワークフロースクリプトの変数に割り当てるには、 `変数` `.setDisplayValue(gs.nowDateTime);` を使用します。

表 : 101. 返される内容
タイプ	説明
なし

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 パラメーターと一致しない場合、ランタイム例外をスローします。例外がキャッチされた後、GlideDateTime オブジェクトで getErrorMsg() を呼び出して、エラーメッセージを取得できます。

表 : 102. パラメーター
名前	タイプ	説明
value	文字列	現在のユーザーのタイムゾーンの日時。
format	文字列	valueパラメーターの解析に使用する日付と時刻の形式。 valueパラメーターを説明するには、次の値を使用します。 dd:日付 MM:月 yyyy:年 HH:時間 mm:分 ss:秒例:「dd-MM-yyyy HH:mm:ss」または「MM-dd-yyyy HH:mm」。

表 : 103. 返される内容
タイプ	説明
なし

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(String value)

内部形式 (yyyy-MM-dd HH:mm:ss) と現在のユーザーのタイムゾーンを使用して、日付と時刻の値を設定します。

表 : 104. パラメーター
名前	タイプ	説明
value	文字列	内部形式の日付と時刻。

表 : 105. 返される内容
タイプ	説明
なし

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(String dateTime, String style)

現在のユーザーのロケールに従って、指定されたスタイルと形式を使用して日付と時刻を設定します。

表 : 106. パラメーター
名前	タイプ	説明
日時	文字列	現在のユーザーのタイムゾーンでの GlideDate オブジェクトの日付と時刻の値。有効な値は、 getDisplayValueLang() 関数からの日付と時刻の出力です。たとえば、このトピックで前述した getDisplayValueLang(String style, String language) の例からの出力を使用すると、 2022 年 11 月 28 日 07:03:41 または 28.11.2022 07:03:41 が許容値です。
style	文字列	日付形式を指定します。有効な値： FULL:ユーザーのロケール (2022 年 10 月 24 日月曜日など) に応じて、<平日、月、日、年> の形式で日付を返します。 long:ユーザーのロケール (2022 年 10 月 24 日など) に応じて、日付を <月、日、年>の形式で返します。 medium: long と似ていますが、月を省略した日付を返します (例:2022 年 10 月 24 日)。 short:ユーザーのロケール (10/24/2022 または 24/10/2022 など) に応じて、MM/DD/YY または DD/MM/YY の形式で日付を返します。他の値が渡された場合、API はデフォルトで `中程度`を使用します。許可される値では大文字と小文字は区別されません。

表 : 107. 返される内容
タイプ	説明
なし

次の例では、日付と時刻を短いスタイルと完全なスタイルで返します。

var glideDateFR = new GlideDateTime();
glideDateFR.setDisplayValueLang("2/3/2023 17:27:56", "short");

gs.info('date: ' + glideDateFR.getDisplayValue());
gs.info('date: ' + glideDateFR.getDisplayValueLang("full"));

出力：

date: 2023-02-03 17:27:56
date: Friday, February 3, 2023 17:27:56

スコープ付き GlideDateTime - setDisplayValueLang(String dateTime, String style, String language)

現在のユーザーのロケールに従って、指定されたスタイル、言語、および形式を使用して日付と時刻を設定します。

表 : 108. パラメーター
名前	タイプ	説明
日時	文字列	現在のユーザーのタイムゾーンでの GlideDate オブジェクトの日付と時刻の値。有効な値は、 getDisplayValueLang() 関数からの日付と時刻の出力です。たとえば、このトピックで前述した getDisplayValueLang(String style, String language) の例からの出力を使用すると、 2022 年 11 月 28 日 07:03:41 または 28.11.2022 07:03:41 が許容値です。
style	文字列	日付形式を指定します。有効な値： FULL:ユーザーのロケール (2022 年 10 月 24 日月曜日など) に応じて、<平日、月、日、年> の形式で日付を返します。 long:ユーザーのロケール (2022 年 10 月 24 日など) に応じて、日付を <月、日、年>の形式で返します。 medium: long と似ていますが、月を省略した日付を返します (例:2022 年 10 月 24 日)。 short:ユーザーのロケール (10/24/2022 または 24/10/2022 など) に応じて、MM/DD/YY または DD/MM/YY の形式で日付を返します。他の値が渡された場合、API はデフォルトで `中程度`を使用します。許可される値では大文字と小文字は区別されません。
言語	文字列	BCP-47 標準に準拠した言語タグを使用して言語を設定します。たとえば、フランス語の場合は `fr` 、イギリス英語の場合は `en-UK` です。許可される値の完全なリストについては、「 BCP 47 言語コードリスト」を参照してください。

表 : 109. 返される内容
タイプ	説明
なし

次の例では、英語とフランス語の日付と時刻を短いスタイルと完全なスタイルで返します。

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 パラメーターを使用して新しいオブジェクトをインスタンス化することと同じです。

表 : 110. パラメーター
名前	タイプ	説明
g	GlideDateTime	日時値の設定に使用するオブジェクト。

表 : 111. 返される内容
タイプ	説明
なし

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 オブジェクトによって格納されている月を、現在のユーザーのタイムゾーンを使用して指定された値に設定します。

表 : 112. パラメーター
名前	タイプ	説明
月	番号	変更先の月。

表 : 113. 返される内容
タイプ	説明
なし

var gdt = new GlideDateTime();
gdt.setMonthLocalTime(1);
gs.info(gdt.getMonthLocalTime());

出力:

スコープ対象 GlideDateTime - setMonthUTC(数値月)

UTC タイムゾーンを使用して、GlideDateTime オブジェクトによって保存された月を指定された値に設定します。

表 : 114. パラメーター
名前	タイプ	説明
月	番号	変更先の月。

表 : 115. 返される内容
タイプ	説明
なし

var gdt = new GlideDateTime();
gdt.setMonthUTC(1);
gs.info(gdt.getMonthUTC());

出力:

スコープ対象 GlideDateTime - setValue(String o)

GlideDateTime オブジェクトの日時を設定します。

表 : 116. パラメーター
名前	タイプ	説明
o	文字列	使用する日時。このパラメーターは、次のいくつかのタイプのいずれかになります。 UTC タイムゾーンの文字列で、内部形式は yyyy-MM-dd HH:mm:ss です。オブジェクトの値を指定された日時に設定します。このメソッドは、 GlideDateTime(String value) コンストラクターを使用して新しい GlideDateTime オブジェクトをインスタンス化することと同じです。使用されている日付と時刻の形式が内部形式と一致しない場合、メソッドは他の利用可能な形式を使用して日付と時刻を設定しようとします。この方法で日付と時刻を解決すると、日と月の値があいまいになるため、データが不正確になる可能性があります。非標準の日付と時刻の形式を使用する場合は、代わりに setValueUTC(String dt, String format) を使用します。 GlideDateTime オブジェクト。オブジェクトの値を、パラメーターに渡された GlideDateTime によって格納された日時に設定します。このメソッドは、 GlideDateTime(GlideDateTime g) コンストラクターを使用して新しい GlideDateTime オブジェクトをインスタンス化することと同じです。 JavaScript 番号。[数値] の値を使用して、1970 年 1 月 1 日 00:00:00 UTC を過ぎたミリ秒としてオブジェクトの値を設定します。

表 : 117. 返される内容
タイプ	説明
なし

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(String dt, String format)

UTC タイムゾーンと指定された日時形式を使用して、日付と時刻の値を設定します。このメソッドは、 dt パラメーターで使用される日付と時刻の形式が format パラメーターと一致しない場合、ランタイム例外をスローします。例外がキャッチされた後、GlideDateTime オブジェクトで getErrorMsg() を呼び出して、エラーメッセージを取得できます。

表 : 118. パラメーター
名前	タイプ	説明
dt	文字列	使用する日時。
format	文字列	使用する日付と時刻の形式。

表 : 119. 返される内容
タイプ	説明
なし

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(数値年)

GlideDateTime オブジェクトによって保存された年を、現在のユーザーのタイムゾーンを使用して指定された値に設定します。

表 : 120. パラメーター
名前	タイプ	説明
年	番号	変更先の年。

表 : 121. 返される内容
タイプ	説明
なし

var gdt = new GlideDateTime();
gdt.setYearLocalTime(2013);
gs.info(gdt.getYearLocalTime());

出力:

スコープ対象 GlideDateTime - setYearUTC(数値年)

UTC タイムゾーンを使用して、GlideDateTime オブジェクトによって保存された年を指定された値に設定します。

表 : 122. パラメーター
名前	タイプ	説明
年	番号	変更先の年。

表 : 123. 返される内容
タイプ	説明
なし

var gdt = new GlideDateTime();
gdt.setYearUTC(2013);
gs.info(gdt.getYearUTC());

出力:

スコープ対象 GlideDateTime - subtract(GlideTime time)

現在の GlideDateTime オブジェクトから指定された時間を減算します。

表 : 124. パラメーター
名前	タイプ	説明
time	GlideTime	減算する時間値。

表 : 125. 返される内容
タイプ	説明
なし

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(ミリ秒数)

GlideDateTime オブジェクトから指定されたミリ秒数を減算します。

表 : 126. パラメーター
名前	タイプ	説明
ミリ秒	番号	減算するミリ秒数。

表 : 127. 返される内容
タイプ	説明
なし

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 オブジェクト間の期間差を返します。

表 : 128. パラメーター
名前	タイプ	説明
開始	GlideDateTime	開始日オブジェクト。
終了	GlideDateTime	終了日オブジェクト。

表 : 129. 返される内容
タイプ	説明
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() と同等です。

表 : 130. パラメーター
名前	タイプ	説明
なし

表 : 131. 返される内容
タイプ
文字列	GlideDateTime オブジェクトによってシステムのタイムゾーンと形式で保存された日付と時刻。

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.toString());

出力:

2011-08-31 08:00:00