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/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. パラメーター
名前	タイプ	説明
日時	文字列	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 gdt)

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

表 : 3. パラメーター
名前	タイプ	説明
GDT	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(ミリ秒数)

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

表 : 4. パラメーター
名前	タイプ	説明
ミリ秒	番号	加算するミリ秒単位

表 : 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 時間)

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

指定された日数を現在の 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(日数)

指定された日数を現在の 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(日数)

指定された日数を現在の 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(秒数)

指定された秒数を 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(週数)

指定された週数を現在の 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(週数)

指定された週数を現在の 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(週数)

指定された週数を現在の 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 - addMonths(月数)

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

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

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

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

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

出力:

2011-10-31

GlideDateTime - addMonthsLocalTime(数値月数)

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

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

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

表 : 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(数値月数)

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

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

タイプ glide_date_time のデータベース列を操作する場合は、日付と時刻の計算を実行する前に、まずフィールド値を GlideDateTime オブジェクトに変換する必要があります。glide_date_timeフィールドは GlideElement として表されます。Glide 要素の呼び出し - getGlideObject() は、日付操作メソッドをサポートする GlideDateTime オブジェクトを返します。詳細については、「GlideElement:getGlideObject()」を参照してください。

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

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

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

出力:

2011-10-31

次の例は、レコードから DateTime フィールドを読み取り、UTC 時間を使用して月を追加し、更新された値をフィールドに書き戻す方法を示しています。

// Add 3 months (UTC) to a glide_date_time field on the current record
var monthsToAdd = 3;

// Convert the glide_date_time field (GlideElement) to a GlideDateTime object
var gdt = current.u_renewal_date.getGlideObject();

// Add months using UTC time
gdt.addMonthsUTC(monthsToAdd);

// Store the updated value back to the field using the internal (UTC) format
current.u_renewal_date.setValue(gdt.getValue());

スコープ対応

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

GlideDateTime - addYears(年数)

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

このメソッドの代わりに addYearsLocalTime() または addYearsUTC() を使用してください。

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

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

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

出力:

2011-08-31

GlideDateTime - addYearsLocalTime(年数)

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

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

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

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

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

GlideDateTime オブジェクトによって格納された日付と時刻の値は、UTC タイムゾーンであるものとして解釈されます。

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

表 : 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(オブジェクトの日時)

2 つの日付と時刻のオブジェクトを比較して、一方が他方の前に出現するか、または同等であるかを判断します。

表 : 34. パラメーター
名前	タイプ	説明
日時	オブジェクト	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(文字列スタイル)

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

表 : 62. パラメーター
名前	タイプ	説明
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 はデフォルトで `中程度`を使用します。許可される値では大文字と小文字は区別されません。

表 : 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 日など) に応じて、日付を <月、日、年>の形式で返します。 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 言語コードリスト」を参照してください。

表 : 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 を使用して、指定された日の午前 0 時に設定された日付と時刻のオブジェクトを返します。

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

表 : 73. 返される内容
タイプ	説明
GlideDateTime	午前 0 時に設定された GlideDateTime オブジェクト。

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

出力:

2011-08-30 00:00:01

GlideDateTime - getLocalDate()

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

表 : 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(数値曜日)

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

表 : 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 オブジェクト。

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 タイムゾーンを使用して、時刻が午前 0 時に設定された GlideDateTime オブジェクトを取得します。

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

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

表 : 97. 返される内容
タイプ	説明
GlideDateTime	午前 0 時に設定された新しい 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 オブジェクトによって保存され、現在のユーザーのタイムゾーンで表される週の番号を取得します。

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

表 : 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 タイムゾーンで表される週の数を取得します。

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

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

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

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

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

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

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

出力:

GlideDateTime - setDayOfMonthLocalTime(日数)

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

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

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

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

出力:

スコープ対応

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

GlideDateTime - setDayOfMonthUTC(数値日)

月の日を 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 など、現在のユーザーの優先表示形式を使用して書式設定する必要があります。現在の日付と時刻をワークフロースクリプトの変数に割り当てるには、 `<variable>.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, 文字列形式)

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

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

表 : 124. パラメーター
名前	タイプ	説明
日時	文字列	現在のユーザーのタイムゾーンの日時。
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. パラメーター
名前	タイプ	説明
日時	文字列	内部形式の日時

表 : 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. パラメーター
名前	タイプ	説明
日時	文字列	内部形式の日付と時刻。

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

GlideDateTime - setDisplayValueLang(文字列 dateTime, 文字列スタイル)

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

表 : 130. パラメーター
名前	タイプ	説明
日時	文字列	現在のユーザーのタイムゾーンでの 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 はデフォルトで `中程度`を使用します。許可される値では大文字と小文字は区別されません。

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

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

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)

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

表 : 132. パラメーター
名前	タイプ	説明
日時	文字列	現在のユーザーのタイムゾーンでの 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 言語コードリスト」を参照してください。

表 : 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 オブジェクト

表 : 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(Object) と同等です。

表 : 136. パラメーター
名前	タイプ	説明
日時	文字列	使用する日時。内部形式の 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(数値月)

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

このメソッドの代わりに 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(数値月)

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

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

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

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

出力:

スコープ対応

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

GlideDateTime - setNumericValue(ミリ秒数)

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

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

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

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

出力:

2011-08-31 08:00:00

GlideDateTime - setTZ(タイムゾーンタイムゾーン)

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

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

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

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

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

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

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

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

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, 文字列形式)

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

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

表 : 150. パラメーター
名前	タイプ	説明
日時	文字列	使用する日時。
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(数値年)

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

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

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

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

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

出力:

GlideDateTime - setYearLocalTime(数値年)

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

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

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

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

出力:

スコープ対応

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

GlideDateTime - setYearUTC(数値年)

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

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

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

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

出力:

スコープ対応

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

GlideDateTime - subtract(GlideTime 時間)

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

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

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

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

表 : 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 開始、GlideDateTime 終了)

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

表 : 162. パラメーター
名前	タイプ	説明
start	GlideDateTime	開始日オブジェクト。
終了	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() を使用します。

GlideDateTime - グローバル

glide_date_timeフィールドの変更

GlideDateTime:GlideDateTime()

GlideDateTime:GlideDateTime(文字列 dateTime)

GlideDateTime:GlideDateTime(GlideDateTime gdt)

GlideDateTime - add(ミリ秒数)

スコープ対応

GlideDateTime - add(GlideTime 時間)

スコープ対応

GlideDateTime - addDays(日数)

GlideDateTime - addDaysLocalTime(日数)

スコープ対応

GlideDateTime - addDaysUTC(日数)

スコープ対応

GlideDateTime - addSeconds(秒数)

スコープ対応

GlideDateTime - addWeeks(週数)

GlideDateTime - addWeeksLocalTime(週数)

スコープ対応

GlideDateTime - addWeeksUTC(週数)

スコープ対応

GlideDateTime - addMonths(月数)

GlideDateTime - addMonthsLocalTime(数値月数)

スコープ対応

GlideDateTime - addMonthsUTC(数値月数)

スコープ対応

GlideDateTime - addYears(年数)

GlideDateTime - addYearsLocalTime(年数)

スコープ対応

GlideDateTime - addYearsUTC(年数)

スコープ対応

GlideDateTime - compareTo(オブジェクトの日時)

スコープ対応

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

スコープ対応

GlideDateTime:getDate()

スコープ対応

GlideDateTime:getDayOfMonth()

GlideDateTime:getDayOfMonthLocalTime()

スコープ対応

GlideDateTime - getDayOfMonthUTC()

スコープ対応

GlideDateTime:getDayOfWeek()

GlideDateTime:getDayOfWeekLocalTime()

スコープ対応

GlideDateTime - getDayOfWeekUTC()

スコープ対応

GlideDateTime:getDaysInMonth()

GlideDateTime - getDaysInMonthLocalTime()

スコープ対応

GlideDateTime - getDaysInMonthUTC()

スコープ対応

GlideDateTime - getDisplayValue()

スコープ対応

GlideDateTime - getDisplayValueInternal()

スコープ対応

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

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

GlideDateTime - getDSTOffset()

スコープ対応

GlideDateTime - getErrorMsg()

スコープ対応

GlideDateTime - getInternalFormattedLocalTime()

スコープ対応

GlideDateTime - getInternalMidnight(数値 dayOfTheWeek)

GlideDateTime - getLocalDate()

スコープ対応

GlideDateTime:getLocalTime()

スコープ対応

GlideDateTime:getMonth()

GlideDateTime - getMonthLocalTime()

スコープ対応

GlideDateTime:getMonthUTC()

スコープ対応

GlideDateTime - getNumericValue()

GlideDateTime - getSpanTime(数値曜日)

GlideDateTime:getTime()

スコープ対応

GlideDateTime - getTZOffset()

スコープ対応

GlideDateTime - setTZ(タイムゾーンタイムゾーン)

GlideDateTime - setYearLocalTime(数値年)