GlideDateTime - グローバル
GlideDateTime クラスは、GlideDateTime オブジェクトに対して操作を実行するためのメソッドを提供します。
GlideDateTime メソッドを使用して、GlideDateTime オブジェクトのインスタンス化、日時計算の実行、日時の書式設定、日時形式間の変換などの日時操作を実行します。
glide_date_timeフィールドの変更
GlideDateTime メソッドでタイプ glide_date_time のデータベース列を操作する場合は、日付と時刻の計算を実行する前に、まずフィールド値を GlideDateTime オブジェクトに変換する必要があります。glide_date_timeフィールドは GlideElement として表されます。Glide 要素の呼び出し - getGlideObject() は、addMonthsUTC() などの日付操作メソッドをサポートする GlideDateTime オブジェクトを返します。詳細については、「GlideElement:getGlideObject()」を参照してください。
一般的な形式競合のリストを含む日時入力文字列のガイダンスについては、「 日付形式のガイドライン」を参照してください。
GlideDateTime:GlideDateTime()
現在の日付と時刻で新しい GlideDateTime オブジェクトをインスタンス化します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
この例では、 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
| 名前 | タイプ | 説明 |
|---|---|---|
| 日時 | 文字列 | 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 オブジェクトをインスタンス化します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 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 オブジェクトに追加します。
| 名前 | タイプ | 説明 |
|---|---|---|
| ミリ秒 | 番号 | 加算するミリ秒単位 |
| タイプ | 説明 |
|---|---|
| なし |
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 オブジェクトを追加します。
| 名前 | タイプ | 説明 |
|---|---|---|
| time | GlideTime | 指定された GlideDateTime オブジェクトに時間値を追加する GlideTime オブジェクト。 |
| タイプ | 説明 |
|---|---|
| なし |
この例では、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() を使用することもできます。
| 名前 | タイプ | 説明 |
|---|---|---|
| days | 番号 | 追加する日数。減算するには負の数を使用します。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addDays(-1);
gs.print(gdt.getDate());
出力:
2011-08-30
GlideDateTime - addDaysLocalTime(日数)
指定された日数を現在の GlideDateTime オブジェクトに追加します。負のパラメーターは日数を減算します。
このメソッドは、GlideDateTime オブジェクトによって格納された値に相当する現地の日時を決定し、その現地の日時の値を使用して日数を加算または減算します。
| 名前 | タイプ | 説明 |
|---|---|---|
| days | 番号 | 追加する日数。減算するには負の値を使用します。 |
| タイプ | 説明 |
|---|---|
| なし |
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 日付と時刻の値を使用して日数を加算または減算します。
| 名前 | タイプ | 説明 |
|---|---|---|
| days | 番号 | 追加する日数。減算するには負の値を使用します。 |
| タイプ | 説明 |
|---|---|
| なし |
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 オブジェクトに追加します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 秒 | 番号 | 追加する秒数 |
| タイプ | 説明 |
|---|---|
| なし |
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() を使用します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 週 | 番号 | 追加する週数。減算するには負の数を使用します。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addWeeks(-1);
gs.print(gdt.getDate());
出力:
2011-08-24
GlideDateTime - addWeeksLocalTime(週数)
指定された週数を現在の GlideDateTime オブジェクトに追加します。負のパラメーターは週を減算します。
このメソッドは、GlideDateTime オブジェクトによって格納された値と同等の現地日時を決定し、現地の日付と時刻の値を使用して週を加算または減算します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 週 | 番号 | 追加する週数。減算するには負の数を使用します。 |
| タイプ | 説明 |
|---|---|
| なし |
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 日付と時刻の値を使用して週を加算または減算します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 週 | 番号 | 追加する週数。減算するには負の数を使用します。 |
| タイプ | 説明 |
|---|---|
| なし |
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() を使用します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 月 | 番号 | 追加する月数。減算するには負の数を使用します。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gdt.addMonths(2);
gs.print(gdt.getDate());
出力:
2011-10-31
GlideDateTime - addMonthsLocalTime(数値月数)
現在の GlideDateTime オブジェクトに指定された月数を追加します。負のパラメーターは月を減算します。
このメソッドは、GlideDateTime オブジェクトによって格納された値と同等の現地日時を決定し、現地の日付と時刻の値を使用して月を加算または減算します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 月 | 番号 | 追加する月数。減算するには負の値を使用します。 |
| タイプ | 説明 |
|---|---|
| なし |
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()」を参照してください。
| 名前 | タイプ | 説明 |
|---|---|---|
| 月 | 番号 | 追加する月数。減算するには負の数を使用します。 |
| タイプ | 説明 |
|---|---|
| なし |
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() を使用してください。
| 名前 | タイプ | 説明 |
|---|---|---|
| 年 | 番号 | 追加する年数。減算するには負の値を使用します。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime("2010-08-31 08:00:00");
gdt.addYears(1);
gs.print(gdt.getDate());
出力:
2011-08-31
GlideDateTime - addYearsLocalTime(年数)
現在の GlideDateTime オブジェクトに指定された年数を追加します。負のパラメーターは年を減算します。
このメソッドは、GlideDateTime オブジェクトによって格納された値と同等の現地日時を決定し、現地の日付と時刻の値を使用して年を加算または減算します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 年 | 番号 | 追加する年数。減算するには、負の値を使用します。 |
| タイプ | 説明 |
|---|---|
| なし |
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 タイムゾーンであるものとして解釈されます。
| 名前 | タイプ | 説明 |
|---|---|---|
| 年 | 番号 | 追加する年数。減算するには負の値を使用します。 |
| タイプ | 説明 |
|---|---|
| なし |
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 つの日付と時刻のオブジェクトを比較して、一方が他方の前に出現するか、または同等であるかを判断します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 日時 | オブジェクト | GlideDateTime オブジェクトの日時 |
| タイプ | 説明 |
|---|---|
| 番号 |
|
var initDate = new GlideDateTime("2011-08-01 12:00:00");
var compDate1 = new GlideDateTime("2011-08-01 12:00:00");
var compDate2 = new GlideDateTime("2011-07-31 12:00:00");
var compDate3 = new GlideDateTime("2011-08-04 16:00:00");
gs.info(initDate.compareTo(compDate1)); // Equals (0)
gs.info(initDate.compareTo(compDate2)); // initDate is after compDate2 (1)
gs.info(initDate.compareTo(compDate3)); // initDate is before compDate3 (-1)
出力:
0
1
-1
スコープ対応
スコープ対象のアプリケーションで compareTo() メソッドを使用するには、対応するスコープ対象のメソッド compareTo() を使用します。
GlideDateTime - equals(オブジェクト GDT)
等価性についてオブジェクトを既存の値と比較します。
| 名前 | タイプ | 説明 |
|---|---|---|
| GDT | オブジェクト | 比較するオブジェクト。GlideDateTIme オブジェクトまたは有効な日時文字列を指定できます。 |
| タイプ | 説明 |
|---|---|
| ブーリアン | 等しい場合は 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) で表されます。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 文字列 | システムタイムゾーンの日付。 形式: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() を使用します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 番号 | UTC タイムゾーンの日付 (1 〜 31)。 |
var gdt = new GlideDateTime("2011-12-02 12:00:00");
gs.print(gdt.getDayOfMonth());
出力:
2
GlideDateTime:getDayOfMonthLocalTime()
GlideDateTime オブジェクトによって保存され、現在のユーザーのタイムゾーンで表される月の日付を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 番号 | ユーザーのタイムゾーンの日付 (1 〜 31)。 |
var gdt = new GlideDateTime("2011-12-02 12:00:00");
gs.print(gdt.getDayOfMonthLocalTime());
出力:
2
スコープ対応
スコープ対象のアプリケーションで getDayOfMonthLocalTime() メソッドを使用するには、対応するスコープ付きメソッド getDayOfMonthLocalTime() を使用します。
GlideDateTime - getDayOfMonthUTC()
GlideDateTime オブジェクトによって格納され、UTC タイムゾーンで表される月の日付を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 番号 | UTC タイムゾーンの日付 (1 〜 31)。 |
var gdt = new GlideDateTime("2011-12-02 12:00:00");
gs.print(gdt.getDayOfMonthUTC());
出力:
2
スコープ対応
スコープ対象のアプリケーションで getDayOfMonthUTC() メソッドを使用するには、対応するスコープ対象のメソッド getDayOfMonthUTC() を使用します。
GlideDateTime:getDayOfWeek()
GlideDateTime オブジェクトによって保存され、ユーザーのタイムゾーンで表される曜日を取得します。
このメソッドの代わりに getDayOfWeekLocalTime() と getDayOfWeekUTC() を使用します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 番号 | 曜日の値:月曜日 = 1、... 日曜日 = 7。 |
var gdt = new GlideDateTime("2011-12-01 12:00:00");
gs.print(gdt.getDayOfWeek());
出力:
4
GlideDateTime:getDayOfWeekLocalTime()
GlideDateTime オブジェクトによって保存され、ユーザーのタイムゾーンで表される曜日を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 番号 | 曜日の値:月曜日 = 1、... 日曜日 = 7 |
var gdt = new GlideDateTime("2011-12-01 12:00:00");
gs.print(gdt.getDayOfWeekLocalTime());
出力:
4
スコープ対応
スコープ対象のアプリケーションで getDayOfWeekLocalTime() メソッドを使用するには、対応するスコープ付きメソッド getDayOfWeekLocalTime() を使用します。
GlideDateTime - getDayOfWeekUTC()
GlideDateTime オブジェクトによって格納され、UTC タイムゾーンで表される曜日を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 番号 | 曜日の値:月曜日 = 1、... 日曜日 = 7 |
var gdt = new GlideDateTime("2011-12-01 12:00:00");
gs.print(gdt.getDayOfWeekUTC());
出力:
4
スコープ対応
スコープ対象のアプリケーションで getDayOfWeekUTC() メソッドを使用するには、対応するスコープ対象のメソッド getDayOfWeekUTC() を使用します。
GlideDateTime:getDaysInMonth()
GlideDateTime オブジェクトによって格納され、Java 仮想マシンのタイムゾーンで表される月の日数を取得します。
このメソッドの代わりに getDaysInMonthLocalTime() と getDaysInMonthUTC() を使用します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 番号 | Java 仮想マシンのタイムゾーンにおける現在の月の日数。 |
var gdt = new GlideDateTime(); //December
gs.print(gdt.getDaysInMonth());
出力:
31
GlideDateTime - getDaysInMonthLocalTime()
GlideDateTime オブジェクトによって保存され、現在のユーザーのタイムゾーンで表される月の日数を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 番号 | ユーザーのタイムゾーンの現在の月の日数。 |
var gdt = new GlideDateTime(); //December
gs.print(gdt.getDaysInMonthLocalTime());
出力:
31
スコープ対応
スコープ対象のアプリケーションで getDaysInMonthLocalTime() メソッドを使用するには、対応するスコープ対象のメソッド getDaysInMonthLocalTime() を使用します。
GlideDateTime - getDaysInMonthUTC()
GlideDateTime オブジェクトによって格納され、UTC タイムゾーンで表される月の日数を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 番号 | GlideDateTime オブジェクトによって格納される月の日数。UTC タイムゾーンで表されます。 |
var gdt = new GlideDateTime(); //December
gs.print(gdt.getDaysInMonthUTC());
出力:
31
スコープ対応
スコープ対象のアプリケーションで getDaysInMonthUTC() メソッドを使用するには、対応するスコープ対象のメソッド getDaysInMonthUTC() を使用します。
GlideDateTime - getDisplayValue()
現在のユーザーの表示形式とタイムゾーンで日付と時刻の値を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| オブジェクト | ユーザーの形式とタイムゾーンの日時。ビジネスルールまたはスクリプトインクルードを設計するときは、このメソッドがユーザーごとに異なる形式で値を返す場合があることに注意してください。 |
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 で返します。このメソッドは、日付/時刻フィールドには便利ですが、日付フィールドには役に立ちません。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| オブジェクト | 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 | 文字列 | 日付と時刻の形式を指定します。 有効な値:
他の値が渡された場合、API はデフォルトで 中程度を使用します。許可される値では大文字と小文字は区別されません。 |
| タイプ | 説明 |
|---|---|
| 文字列 | 指定されたスタイルで、現在のユーザーのロケールに適した形式での日付の文字列表現。 |
次の例では、すべての日付スタイルでユーザーのロケールの日時を返します。
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(文字列スタイル, 文字列言語)
指定された言語と日付スタイルに従って、現在のユーザーのロケールで日付と時刻の値を返します。
| 名前 | タイプ | 説明 |
|---|---|---|
| style | 文字列 | 日付と時刻の形式を指定します。 有効な値:
他の値が渡された場合、API はデフォルトで 中程度を使用します。許可される値では大文字と小文字は区別されません。 |
| 言語 | 文字列 | 指定された言語値に従って日付を返します。BCP-47 標準に準拠する言語タグを受け入れます。たとえば、フランス語の場合は fr 、イギリス英語の場合は en-UK です。許可される値の完全なリストについては、「 BCP 47 言語コードリスト」を参照してください。 |
| タイプ | 説明 |
|---|---|
| 文字列 | 指定されたスタイルで、現在のユーザーのロケールに適した形式での日付の文字列表現。 |
次の例は、すべての言語と日付スタイルでユーザーのロケールの日時を返します。
var gdt = new GlideDateTime(); // This will fetch the current date
gs.info('date: ' + gdt.getDisplayValue());
gs.info('date: ' + gdt.getDisplayValueLang("full", "fr"));
gs.info('date: ' + gdt.getDisplayValueLang("long", "en-GB"));
gs.info('date: ' + gdt.getDisplayValueLang("medium", "de"));
gs.info('date: ' + gdt.getDisplayValueLang("short", "es-MX"));```
出力:
date: 2023-01-18 06:49:02
mercredi 18 janvier 2023 06:49:02
18 January 2023 06:49:02
18.01.2023 06:49:02
18/01/23 06:49:02
GlideDateTime - getDSTOffset()
夏時間がオフセットされる時間を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 番号 | 夏時間がオフセットされる時間 (ミリ秒)。オフセットがない場合、または時刻が夏時間でない場合は 0 を返します。 |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.print(gdt.getDSTOffset());
出力:
3600000
スコープ対応
スコープ対象のアプリケーションで getDSTOffset() メソッドを使用するには、対応するスコープ対象のメソッド getDSTOffset() を使用します。
GlideDateTime - getErrorMsg()
現在のエラーメッセージを取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| オブジェクト | エラーメッセージ |
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()
オブジェクトの時刻をローカルタイムゾーンで内部形式で返します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| オブジェクト | ローカルのタイムゾーンと内部形式でのオブジェクトの時間。 |
この例では、ユーザーのタイムゾーンのシステム時間形式で時間を表示します。
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 時に設定された日付と時刻のオブジェクトを返します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 曜日 | 番号 | 日付/時刻オブジェクトを返す曜日。 |
| タイプ | 説明 |
|---|---|
| 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 オブジェクトによって格納されている日付と、現在のユーザーのタイムゾーンを取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| GlideDate | ユーザーのタイムゾーンの日付。 |
この例では、ユーザーのタイムゾーンの時間形式で時間を表示します。
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.print(gdt.getLocalDate());
出力:
2011-08-31
スコープ対応
スコープ対象のアプリケーションで getLocalDate() メソッドを使用するには、対応するスコープ対象のメソッド getLocalDate() を使用します。
GlideDateTime:getLocalTime()
ユーザーのタイムゾーンで時刻を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 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() を使用します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 番号 | 月の数値。1 月 = 1、12 月 = 12 です。 |
var gdt = new GlideDateTime(); //December
gs.print(gdt.getMonth());
出力:
12
GlideDateTime - getMonthLocalTime()
GlideDateTime オブジェクトによって格納され、現在のユーザーのタイムゾーンで表される月を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 番号 | 月の数値。1 月 = 1、12 月 = 12 です。 |
var gdt = new GlideDateTime(); //December
gs.print(gdt.getMonthLocalTime());
出力:
12
スコープ対応
スコープ対象のアプリケーションで getMonthLocalTime() メソッドを使用するには、対応するスコープ対象のメソッド getMonthLocalTime() を使用します。
GlideDateTime:getMonthUTC()
GlideDateTime オブジェクトによって格納され、UTC タイムゾーンで表される月を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 番号 | 月の数値。1 月 = 1、12 月 = 12 です。 |
var gdt = new GlideDateTime(); //December
gs.print(gdt.getMonthUTC());
出力:
12
スコープ対応
スコープ対象のアプリケーションで getMonthUTC() メソッドを使用するには、対応するスコープ対象のメソッド getMonthUTC() を使用します。
GlideDateTime - getNumericValue()
1970 年 1 月 1 日 00:00:00 GMT からのミリ秒数を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 番号 | 1970 年 1 月 1 日 00:00:00 GMT からのミリ秒数。 |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.print(gdt.getNumericValue());
出力:
1314777600000
GlideDateTime - getSpanTime(数値曜日)
指定された日の深夜から現在時刻までの経過時間を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| dayOfWeek | 番号 | 1 から 7 までの曜日の値。1 = 月曜日、7 = 日曜日。 |
| タイプ | 説明 |
|---|---|
| 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 期間スタンプを取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 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()
タイムゾーンオフセットをミリ秒単位で取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 番号 | タイムゾーンオフセットのミリ秒数 |
var gdt = new GlideDateTime();
gdt.getLocalTime(); // PST local time
gs.print(gdt.getTZOffset());
出力:
-28800000
スコープ対応
スコープ対象のアプリケーションで getTZOffset() メソッドを使用するには、対応するスコープ対象のメソッドである getTZOffset()を使用します。
GlideDateTime - getUserFormattedLocalTime()
ユーザーの形式でローカルタイムゾーンのオブジェクトの時間を返します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| オブジェクト | 現地時間でのオブジェクトの時間とユーザーの形式。 |
次のコード例は、このメソッドを呼び出す方法を示しています。
var gdt = new GlideDateTime('2022-10-08 01:00:00');
gs.info(gdt.getDisplayValue());
gs.info(gdt.getUserFormattedLocalTime());
出力:
2022-10-07 06:00:00 PM
06:00:00 PM
スコープ対応
スコープ対象のアプリケーションで getUserFormattedLocalTime() メソッドを使用するには、対応するスコープ付きメソッド getUserFormattedLocalTime() を使用します。
GlideDateTime - getUserTimeZone()
現在のユーザーセッションのタイムゾーンを取得します。
このメソッドは gs.getSession().getTimeZone() と同等です。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| タイムゾーン | 現在のユーザーの 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 オブジェクトの週内の指定された曜日として設定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 曜日 | 番号 | 曜日 (1 から 7)。月曜日=1、日曜日=7。このパラメーターに 0 を入力しないでください。 |
| タイプ | 説明 |
|---|---|
| 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 タイムゾーンで返します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 文字列 | 内部形式とシステムタイムゾーンの日時。 形式: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 週と見なされます。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 番号 | 現在の週の番号。1 年間で最高の週数は 52 または 53 です。 |
var gdt = new GlideDateTime("2011-12-01 12:00:00");
gs.print(gdt.getWeekOfYearUTC());
出力:
49
スコープ対応
スコープ対象のアプリケーションで getWeekOfYearLocalTime() メソッドを使用するには、対応するスコープ対象のメソッド getWeekOfYearLocalTime() を使用します。
GlideDateTime:getWeekOfYearUTC()
GlideDateTime オブジェクトによって格納され、UTC タイムゾーンで表される週の数を取得します。
すべての週は日曜日に始まります。年の最初の週は、新年の少なくとも 1 日を含む週です。2015 年 12 月 27 日(日曜日)から始まる週は、その週に 1 月 1 日と 2 日があるため、2016 年の第 1 週と見なされます。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 番号 | UTC 時間での現在の週の数。1 年間で最高の週数は 52 または 53 です。 |
var gdt = new GlideDateTime("2011-12-01 12:00:00");
gs.print(gdt.getWeekOfYearUTC());
出力:
49
スコープ対応
スコープ対象のアプリケーションで getWeekOfYearUTC() メソッドを使用するには、対応するスコープ対象のメソッド getWeekOfYearUTC() を使用します。
GlideDateTime:getYear()
GlideDateTime オブジェクトによって格納され、Java 仮想マシンのタイムゾーンで表される年を取得します。
このメソッドの代わりに getYearLocalTime() と getYearUTC() を使用します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 番号 | Java 仮想マシンのタイムゾーンの 4 桁の年値。 |
var gdt = new GlideDateTime(); //2011
gs.print(gdt.getYear());
出力:
2011
GlideDateTime:getYearLocalTime()
GlideDateTime オブジェクトによって格納され、現在のユーザーのタイムゾーンで表される年を取得します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 番号 | ユーザーのタイムゾーンの 4 桁の年値。 |
var gdt = new GlideDateTime(); //2011
gs.print(gdt.getYearLocalTime());
出力:
2011
スコープ対応
スコープ対象のアプリケーションで getYearLocalTime() メソッドを使用するには、対応するスコープ対象のメソッド getYearLocalTime() を使用します。
GlideDateTime:getYearUTC()
GlideDateTime オブジェクトによって格納された年を UTC タイムゾーンで返します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| 番号 | UTC タイムゾーンの 4 桁の年値。 |
var gdt = new GlideDateTime(); //2011
gs.info(gdt.getYearUTC());
出力:
2011
スコープ対応
スコープ対象のアプリケーションで getYearUTC() メソッドを使用するには、対応するスコープ対象のメソッド getYearUTC() を使用します。
GlideDateTime:hasDate()
オブジェクトの日付が設定されているかどうかを決定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| ブーリアン | オブジェクトの日付が設定されている場合は true、それ以外の場合は false。 |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.print(gdt.hasDate());
出力:
true
スコープ対応
スコープ対象のアプリケーションで hasDate() メソッドを使用するには、対応するスコープ対象のメソッド hasDate() を使用します。
GlideDateTime - isDST()
オブジェクトの時間が夏時間オフセットを使用するかどうかを決定します
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| ブーリアン | 時間が夏時間の場合は true、それ以外の場合は false。 |
var gdt = new GlideDateTime("2011-08-31 00:00:00");
gs.print(gdt.isDST()); //true
出力:
true
スコープ対応
スコープ対象のアプリケーションで isDST() メソッドを使用するには、対応するスコープ対象のメソッドである isDST() を使用します。
GlideDateTime:isValid()
値が有効な日時かどうかを判定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| ブーリアン | 値が有効な場合は 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) を使用します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 日 | 番号 | 日付 (1 〜 31)。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime();
gdt.setDayOfMonth(9);
gs.print(gdt.getDayOfMonth());
出力:
9
GlideDateTime - setDayOfMonthLocalTime(日数)
現在のユーザーのタイムゾーンで指定された値に日付を設定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 日 | 番号 | 1 から 31 に変更する月の日付。この値が月の最大日数より大きい場合、値はその月の最終日に設定されます。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime();
gdt.setDayOfMonthLocalTime(9);
gs.print(gdt.getDayOfMonthLocalTime());
出力:
9
スコープ対応
スコープ対象のアプリケーションで setDayOfMonthLocalTime() メソッドを使用するには、対応するスコープ対象のメソッド setDayOfMonthLocalTime() を使用します。
GlideDateTime - setDayOfMonthUTC(数値日)
月の日を UTC タイムゾーンの指定された値に設定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 日 | 番号 | 1 から 31 に変更する月の日付。この値が月の最大日数より大きい場合、値はその月の最終日に設定されます。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime();
gdt.setDayOfMonthUTC(9);
gs.print(gdt.getDayOfMonthUTC());
出力:
9
スコープ対応
スコープ対象のアプリケーションで setDayOfMonthUTC() メソッドを使用するには、対応するスコープ対象のメソッド setDayOfMonthUTC() を使用します。
GlideDateTime:setDisplayValue(文字列 asDisplayed)
現在のユーザーの表示形式とタイムゾーンを使用して日付と時刻の値を設定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| asDisplayed | 文字列 | 現在のユーザーの表示形式とタイムゾーンの日付と時刻。このパラメーターは、MM-dd-yyyy HH:mm:ss など、現在のユーザーの優先表示形式を使用して書式設定する必要があります。現在の日付と時刻をワークフロースクリプトの変数に割り当てるには、 <variable>.setDisplayValue(gs.nowDateTime); を使用します。 |
| タイプ | 説明 |
|---|---|
| なし |
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() を呼び出して、エラーメッセージを取得できます。
| 名前 | タイプ | 説明 |
|---|---|---|
| 日時 | 文字列 | 現在のユーザーのタイムゾーンの日時。 |
| format | 文字列 | dateTime パラメーターの解析に使用する形式。 |
| タイプ | 説明 |
|---|---|
| なし |
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) と現在のユーザーのタイムゾーンを使用して、日付と時刻の値を設定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 日時 | 文字列 | 内部形式の日時 |
| タイプ | 説明 |
|---|---|
| なし |
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) と現在のユーザーのタイムゾーンを使用して、日付と時刻の値を設定します。
このメソッドは、不完全な日付と時刻の値を解析しようとします。
| 名前 | タイプ | 説明 |
|---|---|---|
| 日時 | 文字列 | 内部形式の日付と時刻。 |
| タイプ | 説明 |
|---|---|
| なし |
GlideDateTime - setDisplayValueLang(文字列 dateTime, 文字列スタイル)
現在のユーザーのロケールに従って、指定されたスタイルと形式を使用して日付を設定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 日時 | 文字列 | 現在のユーザーのタイムゾーンでの GlideDate オブジェクトの日付と時刻の値。有効な値は、 getDisplayValueLang() 関数からの日付と時刻の出力です。 たとえば、このトピックで前述した getDisplayValueLang(String style, String language) の例からの出力を使用すると、 2022 年 11 月 28 日 07:03:41 または 28.11.2022 07:03:41 が許容値です。 |
| style | 文字列 | 日付形式を指定します。 有効な値:
他の値が渡された場合、API はデフォルトで 中程度を使用します。許可される値では大文字と小文字は区別されません。 |
| タイプ | 説明 |
|---|---|
| なし |
次の例では、日付と時刻を短いスタイルと完全なスタイルで返します。
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)
現在のユーザーのロケールに従って、指定されたスタイル、言語、および形式を使用して日付と時刻を設定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 日時 | 文字列 | 現在のユーザーのタイムゾーンでの GlideDate オブジェクトの日付と時刻の値。有効な値は、 getDisplayValueLang() 関数からの日付と時刻の出力です。 たとえば、このトピックで前述した getDisplayValueLang(String style, String language) の例からの出力を使用すると、 2022 年 11 月 28 日 07:03:41 または 28.11.2022 07:03:41 が許容値です。 |
| style | 文字列 | 日付形式を指定します。 有効な値:
他の値が渡された場合、API はデフォルトで 中程度を使用します。許可される値では大文字と小文字は区別されません。 |
| 言語 | 文字列 | BCP-47 標準に準拠した言語タグを使用して言語を設定します。たとえば、フランス語の場合は fr 、イギリス英語の場合は en-UK です。許可される値の完全なリストについては、「 BCP 47 言語コードリスト」を参照してください。 |
| タイプ | 説明 |
|---|---|
| なし |
次の例では、英語とフランス語の日付と時刻を短いスタイルと完全なスタイルで返します。
var glideDateFR = new GlideDateTime();
glideDateUS.setDisplayValueLang("2/3/2023 18:00:00", "short", "en-US" );
glideDateFR.setDisplayValueLang("2/3/2023 18:00:00", "short", "fr-FR" );
gs.info('en-US date: ' + glideDateUS.getDisplayValue());
gs.info('en-US date: ' + glideDateUS.getDisplayValueLang("full"));
gs.info('fr-FR date: ' + glideDateFR.getDisplayValue());
gs.info('fr-FR date: ' + glideDateFR.getDisplayValueLang("full"));
出力:
en-US date: 2023-02-03 18:00:00
en-US date: Friday, February 3, 2023 18:00:00
fr-FR date: 2023-03-02 18:00:00
fr-FR date: Thursday, March 2, 2023 18:00:00
GlideDateTime - setGlideDateTime(GlideDateTime gDT)
既存の GlideDateTime オブジェクトを使用して、現在のオブジェクトの日時を設定します。
このメソッドは、GlideDateTime パラメーターを使用して新しいオブジェクトをインスタンス化することと同じです。
| 名前 | タイプ | 説明 |
|---|---|---|
| gDT | GlideDateTime | GlideDateTime オブジェクト |
| タイプ | 説明 |
|---|---|
| なし |
var dt1 = new GlideDateTime("2011-01-01 12:00:00");
var dt2 = new GlideDateTime("2011-02-02 08:00:00");
dt1.setGlideDateTime(dt2);
gs.print(dt1.getValue());
出力:
2011-02-02 08:00:00
スコープ対応
スコープ対象のアプリケーションで setGlideDateTime() メソッドを使用するには、対応するスコープ対象のメソッド setGlideDateTime() を使用します。
GlideDateTime:setInitialValue(文字列 dateTime)
日付と時刻を設定します。
このメソッドは setValue(Object) と同等です。
| 名前 | タイプ | 説明 |
|---|---|---|
| 日時 | 文字列 | 使用する日時。内部形式の GMT タイムゾーンの文字列、または GlideDateTime オブジェクトのいずれかを受け入れます。 |
| タイプ | 説明 |
|---|---|
| なし |
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() を使用します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 月 | 番号 | 変更先の月。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime();
gdt.setMonth(1);
gs.print(gdt.getMonth());
出力:
1
GlideDateTime - setMonthLocalTime(数値 month)
GlideDateTime オブジェクトによって格納されている月を、現在のユーザーのタイムゾーンを使用して指定された値に設定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 月 | 番号 | 変更先の月。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime();
gdt.setMonthLocalTime(1);
gs.print(gdt.getMonthLocalTime());
出力:
1
スコープ対応
スコープ対象のアプリケーションで setMonthLocalTime() メソッドを使用するには、対応するスコープ対象のメソッド setMonthLocalTime() を使用します。
GlideDateTime - setMonthUTC(数値月)
UTC タイムゾーンを使用して、GlideDateTime オブジェクトによって保存された月を指定された値に設定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 月 | 番号 | 変更先の月。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime();
gdt.setMonthUTC(1);
gs.print(gdt.getMonthUTC());
出力:
1
スコープ対応
スコープ対象のアプリケーションで setMonthUTC() メソッドを使用するには、対応するスコープ対象のメソッド setMonthUTC() を使用します。
GlideDateTime - setNumericValue(ミリ秒数)
日時を 1970 年 1 月 1 日 00:00:00 GMT からのミリ秒数に設定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| ミリ秒 | 番号 | ミリ秒数 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime();
gdt.setNumericValue(1314777600000);
gs.print(gdt.getValue());
出力:
2011-08-31 08:00:00
GlideDateTime - setTZ(タイムゾーン タイムゾーン)
GlideDateTime オブジェクトのタイムゾーンを指定されたタイムゾーンに設定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| タイムゾーン | タイムゾーン | タイムゾーンオブジェクト |
| タイプ | 説明 |
|---|---|
| なし |
var tz = gs.getSession().getTimeZone();
var gdt = new GlideDateTime();
gdt.setTZ(tz);
GlideDateTime - setValue(オブジェクト dateTime)
GlideDateTime オブジェクトの日時を設定します。
このメソッドは setInitialValue() と同等です。
| 名前 | タイプ | 説明 |
|---|---|---|
| 日時 | オブジェクト | 使用する日時。このパラメーターは、いくつかのタイプの 1 つです。
|
| タイプ | 説明 |
|---|---|
| なし |
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() を呼び出して、エラーメッセージを取得できます。
| 名前 | タイプ | 説明 |
|---|---|---|
| 日時 | 文字列 | 使用する日時。 |
| format | 文字列 | 使用する形式。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime("2011-01-01 12:00:00");
gdt.setValueUTC("15-02-2011 08:00:00", "dd-MM-yyyy HH:mm:ss");
gs.print(gdt.getValue());
出力:
2011-02-15 08:00:00
スコープ対応
スコープ対象のアプリケーションで setValueUTC() メソッドを使用するには、対応するスコープ対象のメソッド setValueUTC() を使用します。
GlideDateTime - setYear(数値年)
Java 仮想マシンのタイムゾーンを使用して、GlideDateTime オブジェクトによって保存されている年を指定された値に設定します。
このメソッドの代わりに setYearLocalTime() または setYearUTC() を使用します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 年 | 番号 | 変更先の年。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime();
gdt.setYear(2013);
gs.print(gdt.getYear());
出力:
2013
GlideDateTime - setYearLocalTime(数値 年)
GlideDateTime オブジェクトによって保存された年を、現在のユーザーのタイムゾーンを使用して指定された値に設定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 年 | 番号 | 変更先の年。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime();
gdt.setYearLocalTime(2013);
gs.print(gdt.getYearLocalTime());
出力:
2013
スコープ対応
スコープ対象のアプリケーションで setYearLocalTime() メソッドを使用するには、対応するスコープ対象のメソッド setYearLocalTime() を使用します。
GlideDateTime - setYearUTC(数値年)
UTC タイムゾーンを使用して、GlideDateTime オブジェクトによって保存された年を指定された値に設定します。
| 名前 | タイプ | 説明 |
|---|---|---|
| 年 | 番号 | 変更先の年。 |
| タイプ | 説明 |
|---|---|
| なし |
var gdt = new GlideDateTime();
gdt.setYearUTC(2013);
gs.print(gdt.getYearUTC());
出力:
2013
スコープ対応
スコープ対象のアプリケーションで setYearUTC() メソッドを使用するには、対応するスコープ対象のメソッド setYearUTC() を使用します。
GlideDateTime - subtract(GlideTime 時間)
指定された時間を減算します。
| 名前 | タイプ | 説明 |
|---|---|---|
| time | GlideTime | 減算する時間 |
| タイプ | 説明 |
|---|---|
| なし |
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 オブジェクトから指定されたミリ秒数を減算します。
| 名前 | タイプ | 説明 |
|---|---|---|
| ミリ秒 | 番号 | 減算するミリ秒数 |
| タイプ | 説明 |
|---|---|
| なし |
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 オブジェクト間の期間差を返します。
| 名前 | タイプ | 説明 |
|---|---|---|
| start | GlideDateTime | 開始日オブジェクト。 |
| 終了 | GlideDateTime | 終了日オブジェクト。 |
| タイプ | 説明 |
|---|---|
| GlideDuration | 指定された 2 つの日付の期間差。 |
var gdt1 = new GlideDateTime("2011-08-28 09:00:00");
var gdt2 = new GlideDateTime("2011-08-31 08:00:00");
var dur = GlideDateTime.subtract(gdt1, gdt2); // 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() と同等です。
| 名前 | タイプ | 説明 |
|---|---|---|
| なし |
| タイプ | 説明 |
|---|---|
| オブジェクト | GlideDateTime オブジェクトによってシステムのタイムゾーンと形式で保存された日付と時刻。 |
var gdt = new GlideDateTime("2011-08-31 08:00:00");
gs.print(gdt.toString());
出力:
2011-08-31 08:00:00
スコープ対応
スコープ対象のアプリケーションで toString() メソッドを使用するには、対応するスコープ対象のメソッド toString() を使用します。