GlideDateTime - グローバル

GlideDateTime - GlideDateTime()

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

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

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

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

出力:

2022-08-08 16:51:44

GlideDateTime - GlideDateTime(文字列 dateTime)

渡された日時の値を使用して新しい 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

注:

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

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

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

var gdt = new GlideDateTime("2023-01-01 12:00:00");
gs.info(gdt);

出力:

2023-01-01 12:00:00

GlideDateTime - GlideDateTime(GlideDateTime gdt)

指定された GlideDateTime オブジェクトの時刻に設定された新しい GlideDateTime オブジェクトをインスタンス化します。

表 : 3. パラメーター
名前	タイプ	説明
gdt	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(数値 milliseconds)

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

表 : 4. パラメーター
名前	タイプ	説明
milliseconds	数値	加算するミリ秒数。

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

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.print(gdt.getNumericValue());
gdt.add(10);
gs.print(gdt.getNumericValue());

出力：

1314777600000
1314777600010

スコープ対応

スコープ対象のアプリケーションで add() メソッドを使用するには、対応するスコープ対象のメソッド add() を使用します。

GlideDateTime - add(GlideTime time)

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

表 : 6. パラメーター
名前	タイプ	説明
time	GlideTime	指定された GlideDateTime オブジェクトに時間値が加算される GlideTime オブジェクト。

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

この例は、gdt GlideDateTime オブジェクトに設定された時間に 20 秒を加算する方法を示しています。

var gdt = new GlideDateTime("2011-08-31 08:00:00");
var gtime1 = new GlideTime();
gtime1.setValue("00:00:20");
gdt.add(gtime1);
gs.print(gdt.toString());

出力：

2011-08-31 08:00:20

スコープ対応

スコープ対象のアプリケーションで add() メソッドを使用するには、対応するスコープ対象のメソッド add() を使用します。

GlideDateTime - addDays(数値 days)

指定された日数を現在の GlideDateTime オブジェクトに加算します。負のパラメーターは日数を減算します。

このメソッドの代わりに addDaysLocalTime() と addDaysUTC() を使用します。

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

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

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

出力:

2011-08-30

GlideDateTime - addDaysLocalTime(数値 days)

指定された日数を現在の GlideDateTime オブジェクトに加算します。負のパラメーターは日数を減算します。

このメソッドは、GlideDateTime オブジェクトに格納された値に相当する現地日時を判断してから、その現地日時の値を使用して日を加算または減算します。

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

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

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

出力：

2011-08-30

スコープ対応

スコープ対象のアプリケーションで addDaysLocalTime() メソッドを使用するには、対応するスコープ対象のメソッド addDaysLocalTime() を使用します。

GlideDateTime - addDaysUTC(数値 days)

指定された日数を現在の GlideDateTime オブジェクトに加算します。負のパラメーターは日数を減算します。

このメソッドは、GlideDateTime オブジェクトに格納された値に相当する UTC 日時を判断してから、その UTC 日時の値を使用して日を加算または減算します。

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

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

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

出力：

2011-08-30

スコープ対応

スコープ対象のアプリケーションで addDaysUTC() メソッドを使用するには、対応するスコープ対象のメソッド addDaysUTC() を使用します。

GlideDateTime - addSeconds(数値 seconds)

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

表 : 14. パラメーター
名前	タイプ	説明
秒	数値	加算する秒数

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

var gdt = new GlideDateTime("2011-12-07 08:00:00");
gdt.addSeconds(1000);
gs.print(gdt.getValue());

出力：

2011-12-07 08:16:40

スコープ対応

スコープ対象のアプリケーションで addSeconds() メソッドを使用するには、対応するスコープ対象のメソッド addSeconds() を使用します。

GlideDateTime - addWeeks(数値 weeks)

指定された週数を現在の GlideDateTime オブジェクトに加算します。負のパラメーターは週数を減算します。

このメソッドの代わりに addWeeksLocalTime() と addWeeksUTC() を使用します。

表 : 16. パラメーター
名前	タイプ	説明
週	数値	加算する週数。減算する場合は負の数値を使用します。

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

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

出力:

2011-08-24

GlideDateTime - addWeeksLocalTime(数値 weeks)

指定された週数を現在の GlideDateTime オブジェクトに加算します。負のパラメーターは週数を減算します。

このメソッドは、GlideDateTime オブジェクトに格納された値に相当する現地日時を判断してから、その現地日時の値を使用して週を加算または減算します。

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

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

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

出力：

2011-08-24

スコープ対応

スコープ対象のアプリケーションで addWeeksLocalTime() メソッドを使用するには、対応するスコープ対象のメソッド addWeeksLocalTime() を使用します。

GlideDateTime - addWeeksUTC(数値 weeks)

指定された週数を現在の GlideDateTime オブジェクトに加算します。負のパラメーターは週数を減算します。

このメソッドは、GlideDateTime オブジェクトに格納された値に相当する UTC 日時を判断してから、その UTC 日時の値を使用して週を加算または減算します。

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

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

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

出力：

2011-08-24

スコープ対応

スコープ対象のアプリケーションで addWeeksUTC() メソッドを使用するには、対応するスコープ対象のメソッドを addWeeksUTC() を使用します。

GlideDateTime - ddMonths(数値 month)

指定された月数を現在の GlideDateTime オブジェクトに加算します。負のパラメーターは月数を減算します。

このメソッドの代わりに addMonthsLocalTime() または addMonthsUTC() を使用します。

表 : 22. パラメーター
名前	タイプ	説明
months	数値	加算する月数。減算する場合は負の数値を使用します。

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

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

出力:

2011-10-31

GlideDateTime - addMonthsLocalTime(数値 months)

指定された月数を現在の GlideDateTime オブジェクトに加算します。負のパラメーターは月数を減算します。

このメソッドは、GlideDateTime オブジェクトに格納された値に相当する現地日時を判断してから、その現地日時の値を使用して月を加算または減算します。

表 : 24. パラメーター
名前	タイプ	説明
months	数値	加算する月数。減算する場合は負の値を使用します。

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

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

出力：

2011-10-31

スコープ対応

スコープ対象のアプリケーションで addMonthsLocalTime() メソッドを使用するには、対応するスコープ対象のメソッド addMonthsLocalTime() を使用します。

GlideDateTime - addMonthsUTC(数値 months)

指定された月数を現在の GlideDateTime オブジェクトに加算します。負のパラメーターは月数を減算します。

このメソッドは、GlideDateTime オブジェクトに格納された値に相当する UTC 日時を判断してから、その UTC 日時の値を使用して月を加算または減算します。

表 : 26. パラメーター
名前	タイプ	説明
months	数値	加算する月数。減算する場合は負の数値を使用します。

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

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

出力：

2011-10-31

スコープ対応

スコープ対象のアプリケーションで addMonthsUTC() メソッドを使用するには、対応するスコープ対象のメソッド addMonthsUTC() を使用します。

GlideDateTime - addYears(数値 years)

指定された年数を現在の GlideDateTime オブジェクトに加算します。負のパラメーターは年数を減算します。

このメソッドの代わりに addYearsLocalTime() または addYearsUTC() を使用します。

表 : 28. パラメーター
名前	タイプ	説明
years	数値	加算する年数。減算する場合は負の値を使用します。

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

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

出力:

2011-08-31

GlideDateTime - addYearsLocalTime(数値 years)

指定された年数を現在の GlideDateTime オブジェクトに加算します。負のパラメーターは年数を減算します。

このメソッドは、GlideDateTime オブジェクトに格納された値に相当する現地日時を判断してから、その現地日時の値を使用して年を加算または減算します。

表 : 30. パラメーター
名前	タイプ	説明
years	数値	加算する年数。減算する場合は負の値を使用します。

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

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

出力：

2011-08-31

スコープ対応

スコープ対象のアプリケーションで AddYearsLocalTime() メソッドを使用するには、対応するスコープ対象のメソッド AddYearsLocalTime() を使用します。

GlideDateTime - addYearsUTC(数値 years)

指定された年数を現在の GlideDateTime オブジェクトに加算します。負のパラメーターは年数を減算します。

GlideDateTime オブジェクトに格納された日時の値は UTC タイムゾーンとして解釈されます。

表 : 32. パラメーター
名前	タイプ	説明
years	数値	加算する年数。減算する場合は負の値を使用します。

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

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

出力：

2011-08-31

スコープ対応

スコープ対象のアプリケーションで addYearsUTC() メソッドを使用するには、対応するスコープ対象のメソッド addYearsUTC() を使用します。

GlideDateTime - compareTo(オブジェクト dateTime)

2 つの日時オブジェクトを比較して、どちらかが前に発生したか、または同時に発生したかを判断します。

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

表 : 35. 返される内容
タイプ	説明
数値	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

スコープ対応

スコープ対象のアプリケーションで compareTo() メソッドを使用するには、対応するスコープ対象のメソッド compareTo() を使用します。

GlideDateTime - equals(オブジェクト GDT)

オブジェクトが既存の値と同じかどうかを比較します。

表 : 36. パラメーター
名前	タイプ	説明
GDT	オブジェクト	比較するオブジェクト。GlideDateTIme オブジェクトまたは有効な日時文字列を指定できます。

表 : 37. 返される内容
タイプ	説明
ブーリアン	同じ場合は true、同じでない場合は false。

var gdt = new GlideDateTime("2011-08-31 00:00:00");
gs.print(gdt.equals("2011-09-30 00:12:01"));

出力：

 false

スコープ対応

スコープ対象のアプリケーションで equals() メソッドを使用するには、対応するスコープ対象のメソッド equals() を使用します。

GlideDateTime - getDate()

GlideDateTime オブジェクトに格納されている日付を返します。デフォルトでは、形式 yyyy-MM-dd およびシステムタイムゾーン (UTC) で表されます。

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

表 : 39. 返される内容
タイプ	説明
文字列	システムタイムゾーンの日付。形式:yyyy-MM-dd、システムタイムゾーンではデフォルトでは UTC。

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

出力:

2011-08-31

スコープ対応

スコープ対象のアプリケーションで getDate() メソッドを使用するには、対応するスコープ対象のメソッド getDate() を使用します。

GlideDateTime - getDayOfMonth()

現在の日付を UTC タイムゾーンで取得します。

このメソッドの代わりに getDayOfMonthLocalTime() と getDayOfMonthUTC() を使用します。

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

表 : 41. 返される内容
タイプ	説明
数値	UTC タイムゾーンでの 1 ～ 31 の日付。

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

出力：

GlideDateTime - getDayOfMonthLocalTime()

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

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

表 : 43. 返される内容
タイプ	説明
数値	ユーザーのタイムゾーンでの 1 ～ 31 の日付。

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

出力：

スコープ対応

スコープ対象のアプリケーションで getDayOfMonthLocalTime() メソッドを使用するには、対応するスコープ対象のメソッド getDayOfMonthLocalTime() を使用します。

GlideDateTime - getDayOfMonthUTC()

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

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

表 : 45. 返される内容
タイプ	説明
数値	UTC タイムゾーンでの 1 ～ 31 の日付。

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

出力：

スコープ対応

スコープ対象のアプリケーションで getDayOfMonthUTC() メソッドを使用するには、対応するスコープ対象のメソッド getDayOfMonthUTC() を使用します。

GlideDateTime - getDayOfWeek()

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

このメソッドの代わりに getDayOfWeekLocalTime() と getDayOfWeekUTC() を使用します。

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

表 : 47. 返される内容
タイプ	説明
数値	曜日の値：月曜日 = 1、... 日曜日 = 7。

var gdt = new GlideDateTime("2011-12-01 12:00:00");
gs.print(gdt.getDayOfWeek());

出力：

GlideDateTime - getDayOfWeekLocalTime()

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

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

表 : 49. 返される内容
タイプ	説明
数値	曜日の値：月曜日 = 1、... 日曜日 = 7。

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

出力：

スコープ対応

スコープ対象のアプリケーションで getDayOfWeekLocalTime() メソッドを使用するには、対応するスコープ対象のメソッド getDayOfWeekLocalTime() を使用します。

GlideDateTime - getDayOfWeekUTC()

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

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

表 : 51. 返される内容
タイプ	説明
数値	曜日の値：月曜日 = 1、... 日曜日 = 7。

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

出力：

スコープ対応

スコープ対象のアプリケーションで getDayOfWeekUTC() メソッドを使用するには、対応するスコープ対象のメソッド getDayOfWeekUTC() を使用します。

GlideDateTime - getDaysInMonth()

GlideDateTime オブジェクトに格納された、Java 仮想マシンのタイムゾーンで表される日数を取得します。

このメソッドの代わりに getDaysInMonthLocalTime() と getDaysInMonthUTC() を使用します。

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

表 : 53. 返される内容
タイプ	説明
数値	Java 仮想マシンのタイムゾーンでの現在の月の日数。

var gdt = new GlideDateTime(); //December
gs.print(gdt.getDaysInMonth());

出力：

GlideDateTime - getDaysInMonthLocalTime()

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

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

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

var gdt = new GlideDateTime(); //December
gs.print(gdt.getDaysInMonthLocalTime());

出力：

スコープ対応

スコープ対象のアプリケーションで getDaysInMonthLocalTime() メソッドを使用するには、対応するスコープ対象のメソッド getDaysInMonthLocalTime() を使用します。

GlideDateTime - getDaysInMonthUTC()

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

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

表 : 57. 返される内容
タイプ	説明
数値	GlideDateTime オブジェクトに格納された、現在のユーザーの UTC タイムゾーンで表される日数。

var gdt = new GlideDateTime(); //December
gs.print(gdt.getDaysInMonthUTC());

出力：

スコープ対応

スコープ対象のアプリケーションで getDaysInMonthUTC() メソッドを使用するには、対応するスコープ対象のメソッド getDaysInMonthUTC() を使用します。

GlideDateTime - getDisplayValue()

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

注:

GlideDateTime オブジェクトを参照すると、日時の値が GMT タイムゾーンで返されます。

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

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

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

出力：

2011-08-31 01:00:00

スコープ対応

スコープ対象のアプリケーションで getDisplayValue() メソッドを使用するには、対応するスコープ対象のメソッド getDisplayValue() を使用します。

GlideDateTime - getDisplayValueInternal()

内部形式 yyyy-MM-dd HH:mm:ss で表示値を返します。この方法は日付/時刻フィールドには有効ですが、日付フィールドには有効ではありません。

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

表 : 61. 返される内容
タイプ	説明
文字列	GlideDateTime オブジェクトの日時の値。形式:yyyy-MM-dd HH:mm:ss (問い合わせユーザーのタイムゾーン)

// The passed in date and time is converted to the caller's time zone.
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.info(gdt.getDisplayValueInternal());

出力:

2011-08-31 01:00:00

スコープ対応

スコープ対象のアプリケーションで getDisplayValueInternal() メソッドを使用するには、対応するスコープ対象のメソッド getDisplayValueInternal() を使用します。

GlideDateTime - getDisplayValueLang(文字列 style)

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

表 : 62. パラメーター
名前	タイプ	説明
style	文字列	日付と時刻の形式を指定します。有効な値： full:ユーザーのロケール (2022 年 10 月 24 日月曜日など) に従って、<平日、月、日、年> の形式で日付を返します。 long:ユーザーのロケール (2022 年 10 月 24 日など) に従って、<月、日、年> の形式で日付を返します。中: Long に似ていますが、日付に省略された月を返します (例: 2022 年 10 月 24 日)。 short:ユーザーのロケールに応じて、MM/DD/YY または DD/MM/YY の形式で日付を返します (たとえば、10/24/2022 または 24/10/2022)。他の値が渡された場合、API は既定で `medium` を使用します。受け入れられる値は大文字と小文字を区別しません。

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

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

var gdt = new GlideDateTime(); // This will fetch the current date


gs.info('date: ' + gdt.getDisplayValue());

gs.info('date: ' + gdt.getDisplayValueLang("full"));
gs.info('date: ' + gdt.getDisplayValueLang("long"));
gs.info('date: ' + gdt.getDisplayValueLang("medium"));
gs.info('date: ' + gdt.getDisplayValueLang("short"));

出力:

date: 2023-01-18 06:49:02
date: Wednesday, January 18, 2023 06:49:02
date: January 18, 2023 06:49:02
date: Jan 18, 2023 06:49:02
date: 1/18/23 06:49:02

GlideDateTime - getDisplayValueLang(文字列スタイル, 文字列言語)

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

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

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

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

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

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

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

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

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

出力：

スコープ対応

スコープ対象のアプリケーションで getDSTOffset() メソッドを使用するには、対応するスコープ対象のメソッド getDSTOffset() を使用します。

GlideDateTime - getErrorMsg()

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

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

表 : 69. 返される内容
タイプ	説明
文字列	エラーメッセージ

var gdt = new GlideDateTime("2011-aa-31 aa:00:00"); //bad
gs.print(gdt.isValid()); //false
gs.print(gdt.getErrorMsg()); //reason

出力：

false
Could not parse DateTime: 2011-aa-31 aa:00:00

スコープ対応

スコープ対象のアプリケーションで getErrorMsg() メソッドを使用するには、対応するスコープ対象のメソッド getErrorMsg() を使用します。

GlideDateTime - getInternalFormattedLocalTime()

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

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

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

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

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

スコープ対応

スコープ対象のアプリケーションで getInternalFormattedLocalTime() メソッドを使用するには、対応するスコープ対象のメソッド getInternalFormattedLocalTime() を使用します。

GlideDateTime - getInternalMidnight(数値 dayOfTheWeek)

UTC を使用して、指定された日付の深夜に設定された日時オブジェクトを返します。

表 : 72. パラメーター
名前	タイプ	説明
dayOfTheWeek	数値	日付/時刻オブジェクトを返す曜日。

表 : 73. 返される内容
タイプ	説明
GlideDateTime	深夜に設定する GlideDateTime オブジェクト。

var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.print(gdt.getInternalMidnight(2));

出力：

2011-08-30 00:00:01

GlideDateTime - getLocalDate()

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

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

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

この例はユーザーのタイムゾーンの時間形式で時刻を表示しています。

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

出力：

2011-08-31

スコープ対応

スコープ対象のアプリケーションで getLocalDate() メソッドを使用するには、対応するスコープ対象のメソッド getLocalDate() を使用します。

GlideDateTime - getLocalTime()

ユーザーのタイムゾーンでの時刻を取得します。

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

表 : 77. 返される内容
タイプ	説明
GlideTime	ユーザーのタイムゾーンでの時刻。

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

出力：

1970-01-01 01:00:00

スコープ対応

スコープ対象のアプリケーションで getLocalTime() メソッドを使用するには、対応するスコープ対象のメソッド getLocalTime() を使用します。

GlideDateTime - getMonth()

GlideDateTime オブジェクトに格納された、Java 仮想マシンのタイムゾーンで表される月を取得します。

このメソッドの代わりに getMonthLocalTime() と getMonthUTC() を使用します。

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

表 : 79. 返される内容
タイプ	説明
数値	月の数値 (1 月 = 1、12 月 = 12)。

var gdt = new GlideDateTime(); //December
gs.print(gdt.getMonth());

出力：

GlideDateTime - getMonthLocalTime()

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

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

表 : 81. 返される内容
タイプ	説明
数値	月の数値 (1 月 = 1、12 月 = 12)。

var gdt = new GlideDateTime(); //December
gs.print(gdt.getMonthLocalTime());

出力：

スコープ対応

スコープ対象のアプリケーションで getMonthLocalTime() メソッドを使用するには、対応するスコープ対象のメソッド getMonthLocalTime() を使用します。

GlideDateTime - getMonthUTC()

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

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

表 : 83. 返される内容
タイプ	説明
数値	月の数値 (1 月 = 1、12 月 = 12)。

var gdt = new GlideDateTime(); //December
gs.print(gdt.getMonthUTC());

出力：

スコープ対応

スコープ対象のアプリケーションで getMonthUTC() メソッドを使用するには、対応するスコープ対象のメソッド getMonthUTC() を使用します。

GlideDateTime - getNumericValue()

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

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

表 : 85. 返される内容
タイプ	説明
数値	1970 年 1 月 1 日 00:00:00 GMT 以降のミリ秒数。

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

出力：

1314777600000

GlideDateTime - getSpanTime(数値 dayOfWeek)

指定された日の深夜から現在の時刻までの経過時間を取得します。

表 : 86. パラメーター
名前	タイプ	説明
dayOfWeek	数値	1 〜 7 の曜日値。1 = 月曜日、7 = 日曜日。

表 : 87. 返される内容
タイプ	説明
GlideTime	指定された日の深夜から経過した時間。分かりやすい用語で結果を表示するには、値を GlideDuration に設定します。

var gdt = new GlideDateTime("2011-08-31 08:00:00"); //Wednesday
var dur = new GlideDuration();
 
var span = gdt.getSpanTime(1); //how much time since Monday 00:00:00
dur.setValue(span);
gs.print(dur.getDisplayValue());

出力：

2 Days 8 Hours

GlideDateTime - getTime()

Unix 期間スタンプを取得します。

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

表 : 89. 返される内容
タイプ	説明
GlideTime	GMT 時間に基づいたシステム形式での Unix 期間スタンプ。

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

出力：

1970-01-01 08:00:00

スコープ対応

スコープ対象のアプリケーションで getTime() メソッドを使用するには、対応するスコープ対象のメソッド getTime() を使用します。

GlideDateTime - getTZOffset()

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

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

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

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

出力：

-28800000

スコープ対応

スコープ対象のアプリケーションで getTZOffset() メソッドを使用するには、対応するスコープ対象のメソッド getTZOffset() を使用します。

GlideDateTime - getUserFormattedLocalTime()

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

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

表 : 93. 返される内容
タイプ	説明
文字列	現地時刻とユーザーの形式でのオブジェクトの時間。

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

スコープ対応

スコープ対象のアプリケーションで getUserFormattedLocalTime() メソッドを使用するには、対応するスコープ対象のメソッド getUserFormattedLocalTime() を使用します。

GlideDateTime - getUserTimeZone()

現在のユーザーセッションのタイムゾーンを取得します。

このメソッドは gs.getSession().getTimeZone()と同じです。

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

表 : 95. 返される内容
タイプ	説明
TimeZone	現在のユーザーの TimeZone オブジェクト。

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

出力：

sun.util.calendar.ZoneInfo[id="America/Los_Angeles",offset=-28800000,dstSavings=3600000,useDaylight=true,transitions=185,
lastRule=java.util.SimpleTimeZone[id=America/Los_Angeles,offset=-28800000,dstSavings=3600000,useDaylight=true,startYear=0,startMode=3,
startMonth=2,startDay=8,startDayOfWeek=1,startTime=7200000,startTimeMode=0,endMode=3,endMonth=10,endDay=1,endDayOfWeek=1,
endTime=7200000,endTimeMode=0]]

GlideDateTime - getUTCMidnight(数値 dayOfTheWeek)

UTC タイムゾーンを使用した時刻が深夜に設定された GlideDateTime オブジェクトを取得します。

このメソッドは、新しい GlideDateTime オブジェクトの日付を元の GlideDateTime オブジェクトの週のうち、指定された曜日に設定します。

表 : 96. パラメーター
名前	タイプ	説明
dayOfTheWeek	数値	曜日 (1 ～ 7)。月曜日 = 1、日曜日 = 7。このパラメーターに 0 を入力しないでください。

表 : 97. 返される内容
タイプ	説明
GlideDateTime	深夜に設定する新しい GlideDateTime オブジェクト。

var gdt = new GlideDateTime("2011-08-31 08:00:00"); // Wednesday, 3rd day of the week.
gs.print(gdt.getUTCMidnight(5)); //Friday, 5th day of the week.

出力：

2011-09-02 00:00:00

GlideDateTime - getValue()

GlideDateTime オブジェクトに格納された日時の値を、デフォルトで内部形式 yyyy-MM-dd HH:mm:ss、システムタイムゾーン、UTC で取得します。

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

表 : 99. 返される内容
タイプ	説明
文字列	内部形式とシステムタイムゾーンでの日時。形式:yyyy-MM-dd HH:mm:ss (デフォルトでは UTC)

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

出力:

2011-08-31 08:00:00

スコープ対応

スコープ対象のアプリケーションで getValue() メソッドを使用するには、対応するスコープ対象のメソッド getValue() を使用します。

GlideDateTime - getWeekOfYearLocalTime()

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

すべての週は日曜日に始まります。年の最初の週は元日が含まれる週です。2015 年 12 月 27 日日曜日から始まる週は、その週に 1 月 1 日と 2 日が含まれているため、2016 年の最初の週とみなされます。

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

表 : 101. 返される内容
タイプ	説明
数値	現在の週数。1 年の週数は最大で 52 または 53 です。

var gdt = new GlideDateTime("2011-12-01 12:00:00");
gs.print(gdt.getWeekOfYearUTC());

出力：

スコープ対応

スコープ対象のアプリケーションで getWeekOfYearLocalTime() メソッドを使用するには、対応するスコープ対象のメソッド getWeekOfYearLocalTime() を使用します。

GlideDateTime - getWeekOfYearUTC()

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

すべての週は日曜日に始まります。年の最初の週は元日が含まれる週です。2015 年 12 月 27 日日曜日から始まる週は、その週に 1 月 1 日と 2 日が含まれているため、2016 年の最初の週とみなされます。

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

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

var gdt = new GlideDateTime("2011-12-01 12:00:00");
gs.print(gdt.getWeekOfYearUTC());

出力：

スコープ対応

スコープ対象のアプリケーションで getWeekOfYearUTC() メソッドを使用するには、対応するスコープ対象のメソッド getWeekOfYearUTC() を使用します。

GlideDateTime - getYear()

GlideDateTime オブジェクトに格納された、Java 仮想マシンのタイムゾーンで表される年を取得します。

このメソッドの代わりに getYearLocalTime() と getYearUTC() を使用します。

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

表 : 105. 返される内容
タイプ	説明
数値	Java 仮想マシンのタイムゾーンでの 4 桁の年の値。

var gdt = new GlideDateTime(); //2011
gs.print(gdt.getYear());

出力：

GlideDateTime - getYearLocalTime()

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

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

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

var gdt = new GlideDateTime(); //2011
gs.print(gdt.getYearLocalTime());

出力：

スコープ対応

スコープ対象のアプリケーションで getYearLocalTime() メソッドを使用するには、対応するスコープ対象のメソッド getYearLocalTime() を使用します。

GlideDateTime - getYearUTC()

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

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

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

var gdt = new GlideDateTime(); //2011
gs.info(gdt.getYearUTC());

出力：

スコープ対応

スコープ対象のアプリケーションで getYearUTC() メソッドを使用するには、対応するスコープ対象のメソッド getYearUTC() を使用します。

GlideDateTime - hasDate()

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

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

表 : 111. 返される内容
タイプ	説明
ブーリアン	オブジェクトの日付が設定されている場合は true、そうでない場合は false。

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

出力：

true

スコープ対応

スコープ対象のアプリケーションで hasDate() メソッドを使用するには、対応するスコープ対象のメソッド hasDate() を使用します。

GlideDateTime - isDST()

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

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

表 : 113. 返される内容
タイプ	説明
ブーリアン	時間が夏時間の場合は true、そうでない場合は false。

var gdt = new GlideDateTime("2011-08-31 00:00:00");
gs.print(gdt.isDST()); //true

出力：

true

スコープ対応

スコープ対象のアプリケーションで isDST() メソッドを使用するには、対応するスコープ対象の isDST() メソッドを使用します。

GlideDateTime - isValid()

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

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

表 : 115. 返される内容
タイプ	説明
ブーリアン	値が有効な場合は true、有効でない場合は false。

var gdt = new GlideDateTime("2011-aa-31 aa:00:00"); 
gs.print(gdt.isValid()); //true
gs.print(gdt.getErrorMsg()); //reason

出力

Invalid date time: '2011-aa-31 aa:00:00', ignored

スコープ対応

スコープ対象のアプリケーションで isValid() メソッドを使用するには、対応するスコープ対象の isValid() メソッドを使用します。

GlideDateTime - setDayOfMonth(数値 day)

日付を指定された値に設定します。

このメソッドの代わりに setDayOfMonthLocalTime(day) と setDayOfMonthUTC(day) を使用します。

表 : 116. パラメーター
名前	タイプ	説明
日	数値	日付 (1 〜 31)。

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

var gdt = new GlideDateTime();
gdt.setDayOfMonth(9);
gs.print(gdt.getDayOfMonth());

出力:

GlideDateTime - setDayOfMonthLocalTime(数値 day)

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

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

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

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

出力：

スコープ対応

スコープ対象のアプリケーションで setDayOfMonthLocalTime() メソッドを使用するには、対応するスコープ対象のメソッド setDayOfMonthLocalTime() を使用します。

GlideDateTime - setDayOfMonthUTC(数値 day)

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

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

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

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

出力：

スコープ対応

スコープ対象のアプリケーションで setDayOfMonthUTC() メソッドを使用するには、対応するスコープ対象のメソッド setDayOfMonthUTC() を使用します。

GlideDateTime - setDisplayValue(文字列 asDisplayed)

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

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

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

var gdt = new GlideDateTime("2011-02-02 12:00:00");
gdt.setDisplayValue("2011-01-01 12:00:00");
gs.print(gdt.getValue());

出力：

2011-01-01 20:00:00

スコープ対応

スコープ対象のアプリケーションで setDisplayValue() メソッドを使用するには、対応するスコープ対象のメソッド setDisplayValue() を使用します。

GlideDateTime - setDisplayValue(文字列 dateTime, 文字列 format)

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

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

表 : 124. パラメーター
名前	タイプ	説明
dateTime	文字列	現在のユーザーのタイムゾーンでの日時。
format	文字列	dateTime パラメーターの解析に使用する形式。

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

var gdt = new GlideDateTime("2011-02-02 12:00:00");
gdt.setDisplayValue("20-5-2011 12:00:00", "dd-MM-yyyy HH:mm:ss");
gs.print(gdt.getValue());

出力：

2011-05-20 19:00:00

スコープ対応

スコープ対象のアプリケーションで setDisplayValue() メソッドを使用するには、対応するスコープ対象のメソッド setDisplayValue() を使用します。

GlideDateTime - setDisplayValueInternal(文字列 dateTime)

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

表 : 126. パラメーター
名前	タイプ	説明
dateTime	文字列	内部形式での日時

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

var gdt = new GlideDateTime("2011-02-02 12:00:00");
gdt.setDisplayValueInternal("2011-01-01 12:00:00");
gs.print(gdt.getValue());

出力：

2011-01-01 20:00:00

スコープ対応

スコープ対象のアプリケーションで setDisplayValueInternal() メソッドを使用するには、対応するスコープ対象のメソッド setDisplayValueInternal() を使用します。

GlideDateTime - setDisplayValueInternalWithAlternates(文字列 dateTime)

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

このメソッドは不完全な日時値の解析を試行します。

表 : 128. パラメーター
名前	タイプ	説明
dateTime	文字列	内部形式での日時。

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

GlideDateTime - setDisplayValueLang(文字列 dateTime, 文字列 style)

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

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

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

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

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)

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

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

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

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

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

既存の GlideDateTime オブジェクトを使用して現在のオブジェクトの日時を設定します。

このメソッドは、GlideDateTime パラメーターで新しいオブジェクトをインスタンス化することと同じです。

表 : 134. パラメーター
名前	タイプ	説明
gDT	GlideDateTime	GlideDateTime object

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

var dt1 = new GlideDateTime("2011-01-01 12:00:00");
var dt2 = new GlideDateTime("2011-02-02 08:00:00");
dt1.setGlideDateTime(dt2);
gs.print(dt1.getValue());

出力：

2011-02-02 08:00:00

スコープ対応

スコープ対象のアプリケーションで setGlideDateTime() メソッドを使用するには、対応するスコープ対象のメソッド setGlideDateTime() を使用してください。

GlideDateTime - setInitialValue(文字列 dateTime)

日時を設定します。

このメソッドは setValue(オブジェクト) と同じです。

表 : 136. パラメーター
名前	タイプ	説明
dateTime	文字列	使用する日時。内部形式の GMT タイムゾーンの文字列または GlideDateTime オブジェクトのいずれかを受け入れます。

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

var gdt = new GlideDateTime();
gdt.setInitialValue("2011-01-01 12:00:00");
gs.print(gdt.getValue());

出力:

2011-01-01 12:00:00

GlideDateTime - setMonth(数値 month)

GlideDateTime オブジェクトに格納された月を Java 仮想マシンのタイムゾーンを使用して指定された値に設定します。

このメソッドの代わりに setMonthLocalTime() または setMonthUTC() を使用します。

表 : 138. パラメーター
名前	タイプ	説明
月	数値	変更先の月。

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

var gdt = new GlideDateTime();
gdt.setMonth(1);
gs.print(gdt.getMonth());

出力:

GlideDateTime - setMonthLocalTime(数値 month)

GlideDateTime オブジェクトに格納された月を現在のユーザーのタイムゾーンを使用して指定された値に設定します。

表 : 140. パラメーター
名前	タイプ	説明
月	数値	変更先の月。

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

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

出力：

スコープ対応

スコープ対象のアプリケーションで setMonthLocalTime() メソッドを使用するには、対応するスコープ対象のメソッド setMonthLocalTime() を使用します。

GlideDateTime - setMonthUTC(数値 month)

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

表 : 142. パラメーター
名前	タイプ	説明
月	数値	変更先の月。

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

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

出力：

スコープ対応

スコープ対象のアプリケーションで setMonthUTC() メソッドを使用するには、対応するスコープ対象のメソッド setMonthUTC() を使用します。

GlideDateTime - setNumericValue(数値 milliseconds)

日時を 1970 年 1 月 1 日 00:00:00 GMT 以降のミリ秒数に設定します。

表 : 144. パラメーター
名前	タイプ	説明
milliseconds	数値	ミリ秒数

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

var gdt = new GlideDateTime();
gdt.setNumericValue(1314777600000);
gs.print(gdt.getValue());

出力:

2011-08-31 08:00:00

GlideDateTime - setTZ(TimeZone timeZone)

GlideDateTime オブジェクトのタイムゾーンを指定されたタイムゾーンに設定します。

表 : 146. パラメーター
名前	タイプ	説明
timeZone	TimeZone	タイムゾーンオブジェクト

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

var tz = gs.getSession().getTimeZone();
var gdt = new GlideDateTime(); 
gdt.setTZ(tz);

GlideDateTime - setValue(オブジェクト dateTime)

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

このメソッドは setInitialValue() と同じです。

表 : 148. パラメーター
名前	タイプ	説明
dateTime	オブジェクト	使用する日時。このパラメーターは次のいずれかの 1 つのタイプです。 UTC タイムゾーンの文字列と yyyy-MM-dd HH:mm:ss の内部形式。オブジェクトの値を指定された日時に設定します。この方法でこのメソッドを使用するのは、`GlideDateTime(value)` コンストラクターを使用して新しい GlideDateTime オブジェクトをインスタンス化するのと同じです。使用した日時形式が内部形式と一致しない場合、メソッドは利用可能な他の形式を使用して日時の設定を試行します。この方法で日時の不一致を解決すると、日付と月の値のあいまいさにより日付が不正確になる可能性があります。非標準の日時形式を使用する場合は、`setValueUTC(dateTime, format)` を代わりに使用します。 GlideDateTime オブジェクト：オブジェクトの値をパラメーターで渡された GlideDateTime に格納された日時に設定します。この方法でこのメソッドを使用するのは、`GlideDateTime(g)` コンストラクターを使用して新しい GlideDateTime オブジェクトをインスタンス化するのと同じです。 Java 日付オブジェクト：Java 日付オブジェクトによって格納されている値を使用して、オブジェクトの値を設定します。この方法でメソッドを使用することは、Java 日付オブジェクト getTime() によって返された値を GlideDateTime setNumericValue() メソッドに渡すことと同じです。このメソッドは JavaScript 日付オブジェクトを受け入れません。 JavaScript の数字：1970 年 1 月 1 日 00:00:00 GMT を過ぎたミリ秒としての数値を使用してオブジェクトの値を設定します。この方法でこのメソッドを使用することは、`setNumericValue(milliseconds)` メソッドと同じです。 Java の整数または Long 型：1970 年 1 月 1 日 00:00:00 GMT を過ぎたミリ秒としての整数または Long 値を使用してオブジェクトの値を設定します。この方法でこのメソッドを使用することは、`setNumericValue(milliseconds)` メソッドと同じです。

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

yyyy-MM-dd HH:mm:ss 形式の文字列を使用して日時を設定します。

var gdt = new GlideDateTime("2011-01-01 12:00:00");
gdt.setValue("2011-02-02 08:00:00");
gs.print(gdt.getValue());

出力：

2011-02-02 08:00:00

既存の GlideDateTime オブジェクトを使用して日時を設定します。

var gdtSource = new GlideDateTime("2017-05-23 11:37:41");
var gdtDest = new GlideDateTime();
gdtDest.setValue(gdtSource);
gs.print(gdtDest.getValue());

出力：

2017-05-23 11:37:41

1970 年 1 月 1 日 00:00:00 GMT を過ぎたミリ秒を示す数字を使用して日時を設定します。

var gdt = new GlideDateTime("2011-01-01 12:00:00");
gdt.setValue(1617634522375);
gs.print(gdt.getValue());

出力：

2021-04-05 14:55:22

スコープ対応

スコープ対象のアプリケーションで setValue() メソッドを使用するには、対応するスコープ対象のメソッド setValue() を使用します。

GlideDateTime - setValueUTC(文字列 dateTime, 文字列 format)

UTC タイムゾーンと指定された日時の表示形式を使用して日時の値を設定します。

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

表 : 150. パラメーター
名前	タイプ	説明
dateTime	文字列	使用する日時。
format	文字列	使用する形式。

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

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.print(gdt.getValue());

出力：

2011-02-15 08:00:00

スコープ対応

スコープ対象のアプリケーションで setValueUTC() メソッドを使用するには、対応するスコープ対象のメソッド setValueUTC() を使用します。

GlideDateTime - setYear(数値 year)

GlideDateTime オブジェクトに格納された年を Java 仮想マシンのタイムゾーンを使用して指定された値に設定します。

このメソッドの代わりに setYearLocalTime() または setYearUTC() を使用します。

表 : 152. パラメーター
名前	タイプ	説明
year	数値	変更先の年。

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

var gdt = new GlideDateTime();
gdt.setYear(2013);
gs.print(gdt.getYear());

出力:

GlideDateTime - setYearLocalTime(数値 year)

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

表 : 154. パラメーター
名前	タイプ	説明
year	数値	変更先の年。

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

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

出力：

スコープ対応

スコープ対象のアプリケーションで setYearLocalTime() メソッドを使用するには、対応するスコープ対象のメソッド setYearLocalTime() を使用します。

GlideDateTime - setYearUTC(数値 year)

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

表 : 156. パラメーター
名前	タイプ	説明
year	数値	変更先の年。

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

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

出力：

スコープ対応

スコープ対象のアプリケーションで setYearUTC() メソッドを使用するには、対応するスコープ対象のメソッド setYearUTC() を使用します。

GlideDateTime - subtract(GlideTime time)

指定された時間を減算します。

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

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

var gdt = new GlideDateTime("2011-08-31 08:00:00");
var gtime1 = new GlideTime();
gtime1.setValue("00:00:20");
gdt.subtract(gtime1);
gs.print(gdt.getTime());

出力：

1970-01-01 07:59:40

スコープ対応

スコープ対象のアプリケーションで subtract() メソッドを使用するには、対応するスコープ対象の subtract() メソッドを使用します。

GlideDateTime - subtract(数値 milliseconds)

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

表 : 160. パラメーター
名前	タイプ	説明
milliseconds	数値	減算するミリ秒数。

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

var gdt = new GlideDateTime("2011-12-07 08:00:00");
gdt.subtract(1000);
gs.print(gdt.getValue());

出力：

2011-12-07 07:59:59

スコープ対応

スコープ対象のアプリケーションで subtract() メソッドを使用するには、対応するスコープ対象の subtract() メソッドを使用します。

GlideDateTime - subtract(GlideDateTime start, GlideDateTime end)

指定された 2 つの GlideDateTime オブジェクト間の期間差を返します。

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

表 : 163. 返される内容
タイプ	説明
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); // Difference between gdt1 and gdt2
gs.info(dur.getDisplayValue());

出力：

2 Days 23 Hours

スコープ対応

スコープ対象のアプリケーションで subtract() メソッドを使用するには、対応するスコープ対象の subtract() メソッドを使用します。

GlideDateTime - toString()

GlideDateTime オブジェクトに格納された日時の値を、デフォルトで内部形式 yyyy-MM-dd HH:mm:ss、システムタイムゾーン、UTC で返します。

このメソッドは getValue() と同じです。

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

表 : 165. 返される内容
タイプ	説明
文字列	システムタイムゾーンと形式での GlideDateTime オブジェクトに格納された日時。

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

出力：

2011-08-31 08:00:00

スコープ対応

スコープ対象のアプリケーションで toString() メソッドを使用するには、対応するスコープ対象のメソッド toString() を使用します。