GlideDate - スコープ対象

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：15分

    • スコープ対象の GlideDate クラスは、GlideDate オブジェクトのインスタンス化や GlideDate フィールドの操作など、GlideDate オブジェクトに対する操作を実行するためのメソッドを提供します。

    一般的な形式競合のリストを含む日時入力文字列のガイダンスについては、「 日付形式のガイドライン」を参照してください。

    「GlideDateTime - スコープ指定」も参照してください。

    スコープ対象 GlideDate:GlideDate()

    現在の日時で GlideDate オブジェクトを作成します。

    表 : 1. パラメーター
    名前 タイプ 説明
    なし 
    //Today's date is April 21, 2021
var gd = new GlideDate();
gs.info(gd.getValue());
    出力: 
    2021-04-21

    スコープ対象 GlideDate:getByFormat(文字列形式)

    指定された日付形式で日付を取得します。

    表 : 2. パラメーター
    名前 タイプ 説明
    format 文字列 Java SimpleDateFormat を使用した目的の日付形式。たとえば、日、月、年を取得する場合は 「dd-MM-yyyy」 、曜日を取得する場合は 「EEEE」 などです。
    表 : 3. 返される内容
    タイプ 説明
    文字列 指定された形式の GlideDate オブジェクトの日付値。 
    var gd = new GlideDate(); 
gd.setValue('2021-04-21');
gs.info(gd.getByFormat("dd-MM-yyyy"));
    出力: 
    21-04-2021

    スコープ付き GlideDate:getDayOfMonthNoTZ()

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

    表 : 4. パラメーター
    名前 タイプ 説明
    なし
    表 : 5. 返される内容
    タイプ 説明
    番号 UTC タイムゾーンの日付 (1 〜 31)。 
    //Today's date is 2016-05-13 
var gd =new GlideDate();
gs.info(gd.getDayOfMonthNoTZ());

    出力:

    13

    スコープ対象 GlideDate - getDisplayValue()

    UTC タイムゾーンの日時フィールド値を取得します。

    関連項目: getDisplayValueInternal()

    表 : 6. パラメーター
    名前 タイプ 説明
    なし
    表 : 7. 返される内容
    タイプ 説明
    文字列 UTC タイムゾーンでの GlideDate オブジェクトの日付値。 
    var gd = new GlideDate(); 
gd.setValue('2025-04-21');
gs.info(gd.getDisplayValue());
    出力: 
    2025-04-21

    スコープ付き GlideDate:getDisplayValueEx(文字列スタイル)

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

    表 : 8. パラメーター
    名前 タイプ 説明
    style 文字列 日付に使用する形式。
    有効な値 (大文字と小文字の区別なし):
    • short:現在のユーザーの言語に応じて M/D/YY または D/M/YY。たとえば、1/27/26 や 27/1/26 などです。
    • medium:短縮された月、日、および年が含まれます。例:Jan 27, 2026。
    • long:月、日、年が含まれます。例:2026 年 1 月 27 日。
    • full:曜日、月、日、年が含まれます。例:2026 年 1 月 27 日火曜日。

    日付は現在のユーザーの言語で返されます。言語によって、日付の月と日の順序が決まります。
    表 : 9. 返される内容
    タイプ 説明
    文字列 指定された形式の日付。

    この例では、現在のユーザーのタイムゾーンと各書式設定オプションを使用して日付を返します。

    var gd = new GlideDate();
gs.info(gd.getDisplayValueEx("short"));
gs.info(gd.getDisplayValueEx("medium"));
gs.info(gd.getDisplayValueEx("long"));
gs.info(gd.getDisplayValueEx("full"));

    出力:

    1/27/26  //short
Jan 27, 2026  //medium
January 27, 2026  //long
Tuesday, January 27, 2026  //full

    スコープ付き GlideDate:getDisplayValueInternal()

    内部形式 (yyyy-MM-dd) の日付と現在のユーザーのタイムゾーンを取得します。

    関連項目 スコープ付き GlideDate:getDisplayValueInternal()

    表 : 10. パラメーター
    名前 タイプ 説明
    なし
    表 : 11. 返される内容
    タイプ 説明
    文字列 現在のユーザーのタイムゾーンでの GlideDate オブジェクトの日付値。

    形式:yyyy-MM-dd

    		 
    var gd = new GlideDate(); 
gs.info(gd.getDisplayValueInternal());
    出力: 
    2021-04-21

    スコープ付き GlideDate - getDisplayValueLang(String style, String language)

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

    表 : 12. パラメーター
    名前 タイプ 説明
    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 言語コードリスト」を参照してください。
    表 : 13. 返される内容
    タイプ 説明
    文字列 現在のユーザーのロケールに従って指定されたスタイルと言語の日付。

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

    var gd = new GlideDate(); // This will fetch the current date


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

gs.info('date: ' + gd.getDisplayValueLang("full", "fr"));
gs.info('date: ' + gd.getDisplayValueLang("long", "en-GB"));
gs.info('date: ' + gd.getDisplayValueLang("medium", "de"));
gs.info('date: ' + gd.getDisplayValueLang("short", "es-MX"));

    出力：

    
date: 2023-01-18
date: mercredi 18 janvier 2023
date: 18 January 2023
date: 18.01.2023
date: 18/01/23

    スコープ付き GlideDate:getMonthNoTZ()

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

    表 : 14. パラメーター
    名前 タイプ 説明
    なし
    表 : 15. 返される内容
    タイプ 説明
    番号 1 から 12 までの月の数値。 
    //Today's date is 2016-05-13
var gd =new GlideDate();
gs.info(gd.getMonthNoTZ());

    出力:

    5

    スコープ付き GlideDate:getValue()

    内部形式 (yyyy-MM-dd) とシステムタイムゾーン (デフォルトでは UTC) で日付を取得します。

    表 : 16. パラメーター
    名前 タイプ 説明
    なし
    表 : 17. 返される内容
    タイプ 説明
    文字列 システムタイムゾーンの GlideDate オブジェクトの日付値。

    形式:yyyy-MM-dd

    		 
    var gd = new GlideDate();
gd.setValue('2021-04-21');
gs.info(gd.getValue());
    出力: 
    2021-04-21

    スコープ付き GlideDate:getYearNoTZ()

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

    表 : 18. パラメーター
    名前 タイプ 説明
    なし
    表 : 19. 返される内容
    タイプ 説明
    番号 年の数値。 
    //Today's date is 2016-05-13
var gd =new GlideDate();
gs.info(gd.getYearNoTZ());

    出力:

    2016

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

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

    表 : 20. パラメーター
    名前 タイプ 説明
    asDisplayed 文字列 現在のユーザーの表示形式とタイムゾーンの日付。

    形式:yyyy-MM-dd など、現在のユーザーの優先表示形式を使用して書式設定する必要があります。
    表 : 21. 返される内容
    タイプ 説明
    なし 
    var gd = new GlideDate();
gd.setDisplayValue("2011-01-01");
gs.info(gd.getValue());

    出力:

    2011-01-01

    スコープ指定 GlideDate - setDisplayValueEx(String date, String style)

    指定された形式を使用して日付を設定します。

    表 : 22. パラメーター
    名前 タイプ 説明
    date 文字列 日付に設定する値。
    getDisplayValueEx() メソッドは、日付を有効な形式で返します。または、日付は次のように書式設定できます。
    • 現在のユーザーの言語に応じて M/D/YY または D/M/YY。たとえば、1/27/26 や 27/1/26 などです。
    • 月、日、年の短縮形。例:Jan 27, 2026。
    • 月、日、年。例:2026 年 1 月 27 日。
    • 曜日、月、日、年。例:2026 年 1 月 27 日火曜日。
    現在のユーザーの言語によって、日付の月と日の順序が決まります。たとえば、現在のユーザーの言語が英語の場合、「 3/21/26 」と「 2026 年 3 月 21 日 」は有効な値で、「 21/3/26 」と「 21 March, 2026 」は無効です。
    style 文字列 日付に使用する形式。

    指定された date 値と同じ形式を使用する必要があります。

    有効な値 (大文字と小文字の区別なし):
    • short:現在のユーザーの言語に応じて M/D/YY または D/M/YY。たとえば、1/27/26 や 27/1/26 などです。
    • medium:月、日、および年の短縮形。例:Jan 27, 2026。
    • long:月、日、年。例:2026 年 1 月 27 日。
    • full:曜日、月、日、年。例:2026 年 1 月 27 日火曜日。
    表 : 23. 返される内容
    タイプ 説明
    なし

    この例では、指定された形式を使用して日付を設定します。

    gd = new GlideDate();
gd.setDisplayValueEx("Jan 28, 2026", "medium");
gs.info(gd.getDisplayValueEx("full"));

    出力:

    Wednesday, January 28, 2026

    スコープ対象 GlideDate - setDisplayValueLang(String date, String style)

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

    表 : 24. パラメーター
    名前 タイプ 説明
    date 文字列 現在のユーザーのタイムゾーンでの GlideDate オブジェクトの日付値。有効な値は、 getDisplayValueLang() 関数からの日付と時刻の出力です。

    たとえば、このトピックで前述した getDisplayValueLang(String style, String language) の例からの出力を使用すると、 2022 年 10 月 25 日 または 2022 年 10 月 25 日が許容される値です。
    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 のデフォルトは 中程度です。許可される値では大文字と小文字は区別されません。
    表 : 25. 返される内容
    タイプ 説明
    なし

    次の例は、 setDisplayValueLang() を使用してユーザーのロケールの現在の日付を「フル」スタイルに設定する方法を示しています。

    glideDate.setDisplayValueLang("2/3/2023", "short");


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

    出力：

    date: 2023-02-03
date: Friday, February 3, 2023

    スコープ対象 GlideDate - setDisplayValueLang(String date, String style, String language)

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

    表 : 26. パラメーター
    名前 タイプ 説明
    date 文字列 現在のユーザーのタイムゾーンでの GlideDate オブジェクトの日付値。有効な値は、 getDisplayValueLang() 関数からの日付と時刻の出力です。

    たとえば、このトピックで前述した getDisplayValueLang(String style, String language) の例からの出力を使用すると、 2022 年 10 月 25 日 または 2022 年 10 月 25 日が許容される値です。
    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 言語コードリスト」を参照してください。
    表 : 27. 返される内容
    タイプ 説明
    なし

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

    var glideDateFR = new GlideDate(); 

glideDateUS.setDisplayValueLang("2/3/202", "short", "en-US" );
glideDateFR.setDisplayValueLang("2/3/2023", "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
en-US date: Friday, February 3, 2023
fr-FR date: 2023-03-02
fr-FR date: Thursday, March 2, 2023

    スコープ対象 GlideDate:setValue(String o)

    現在の GlideDate オブジェクトの日付を内部形式 (yyyy-MM-dd) とシステムタイムゾーン (デフォルトでは UTC) で設定します。

    表 : 28. パラメーター
    名前 タイプ 説明
    o 文字列 現在の GlideDate オブジェクトに設定する日時。

    形式:yyyy-MM-dd
    表 : 29. 返される内容
    タイプ 説明
    なし 
    var gd = new GlideDate(); 
gd.setValue('2015-01-01');
gs.info(gd.getValue());

    出力:

    2015-01-01

    スコープ対象 GlideDate - subtract(GlideDate start, GlideDate end)

    2 つの GlideDate 値の期間差を取得します。

    表 : 30. パラメーター
    名前 タイプ 説明
    開始 GlideDate 開始値。
    終了 GlideDate 終了値。
    表 : 31. 返される内容
    タイプ 説明
    GlideDuration 2 つの値の間の期間。 
    var sgd1 = new GlideDate(); 
sgd1.setDisplayValue('2014-07-18'); 
var sgd2 = new GlideDate(); 
sgd2.setDisplayValue('2014-07-19'); 
 
var duration = GlideDate.subtract(sgd1, sgd2); 
gs.info(duration.getDisplayValue());
    出力: 
    1 Day