GlideDate - グローバル

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：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(文字列 format)

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

    表 : 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 - getByFormat(文字列 format) を使用します。

    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 - getMonthNoTZ() を使用します。

    GlideDate - getDisplayValue()

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

    関連項目: getDisplayValueInternal()

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

    スコープ対応

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

    GlideDate - getDisplayValueInternal()

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

    getDisplayValue() も参照してください

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

    形式：yyyy-MM-dd

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

    スコープ対応

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

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

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

    表 : 10. パラメーター
    名前 タイプ 説明
    style 文字列 日付形式。
    有効な値：
    • full:ユーザーのロケール (2022 年 10 月 24 日月曜日など>に従って<weekday、month、day、year の形式で日付を返します。
    • long: ユーザーのロケール (2022 年 10 月 24 日など> に従って、日付を <月、日、年 の形式で返します。
    • medium: long に似ていますが、省略された月で日付を返します (例:2022 年 10 月 24 日)。
    • short:ユーザーのロケール (10/24/2022 や 24/10/2022 など) に従って、MM/DD/YY または DD/MM/YY の形式で日付を返します。

    他の値が渡された場合、API はデフォルトで medium になります。指定できる値では、大文字と小文字は区別されません。
    表 : 11. 戻り値
    タイプ 説明
    文字列 指定されたスタイルで、現在のユーザーのロケールに適した形式での日付の文字列表現。

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

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


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

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

    出力:

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

    GlideDate - getDisplayValueLang(文字列スタイル、文字列言語)

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

    表 : 12. パラメーター
    名前 タイプ 説明
    style 文字列 日付形式。
    有効な値：
    • full:ユーザーのロケール (2022 年 10 月 24 日月曜日など>に従って<weekday、month、day、year の形式で日付を返します。
    • long: ユーザーのロケール (2022 年 10 月 24 日など> に従って、日付を <月、日、年 の形式で返します。
    • medium: long に似ていますが、省略された月で日付を返します (例:2022 年 10 月 24 日)。
    • short:ユーザーのロケール (10/24/2022 や 24/10/2022 など) に従って、MM/DD/YY または DD/MM/YY の形式で日付を返します。

    他の値が渡された場合、API はデフォルトで medium になります。指定できる値では、大文字と小文字は区別されません。
    言語 文字列 指定された言語値に従って日付を返します。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 - getMonthNoTZ() を使用します。

    GlideDate - getYearNoTZ()

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

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

    出力：

    2016

    スコープ対応

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

    GlideDate - parseDate(文字列日付, 文字列言語, 文字列国)

    渡された言語および国コードに関連付けられたロケールの日付を解析します。

    注:
    このメソッドは失敗し、地域の日付形式に従わない場合に例外がスローされます。
    表 : 18. パラメーター
    名前 タイプ 説明
    date 文字列 地域構文で書式設定された日付。

    形式：

    • 英数字の日付:月を 1 月、2 月、3 月などの 3 文字で指定することも、月の名前を完全に入力することもできます。年は 4 桁、日数は 2 桁でなければなりません。例: 「2020 年 1 月 31 日」 または 「2020 年 1 月 31 日」
    • 数値の日付:日数と月は 2 桁でなければなりません。4 桁は長年にわたって非常に好まれますが、この方法では精度が低く、解析が失敗する可能性が高くなりますが、2 桁の年がサポートされています。地域の日付セパレーターも使用する必要があります。これらのセパレーターは、渡された language 値と country 値に基づいて解析に影響します。例:米国ロケールの場合は「12/31/2020」、エストニアロケールの場合は「31.12.20」。
    言語 文字列 ISO-639 2 文字の言語コード。
    国 文字列 ISO-3166 2 文字の国コード。
    表 : 19. 戻り値
    タイプ 説明
    オブジェクト 計算で使用したり、レコードに挿入したりできる解析済みの GlideDate オブジェクト。

    このメソッドは、日付の解析に失敗した場合に例外をスローします。例外は、日付形式が指定されたロケール形式 (渡された language および country パラメーター) と一致しない場合に発生します。

    次のコード例では、日付を解析し、その日付に 4 週間を追加します。

    var date = GlideDate.parseDate("31 Dec 2020", "en", "GB");
date.addWeeksLocalTime(4);
gs.info("Project is due 4 weeks after start date, on " + date.getDisplayValue());

    出力:

    Project is due 4 weeks after start date, on 2021-01-28

    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 - setDisplayValue(文字列 asDisplayed) を使用します。

    GlideDate - setDisplayValueLang(文字列日付, 文字列スタイル)

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

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

    たとえば、このトピックの前半の getDisplayValueLang(String style, String language) の例からの出力を使用すると、 2022 年 10 月 25 日 または 2022 年 10 月 25 日が許容される値です。
    style 文字列 日付形式。
    有効な値：
    • full:ユーザーのロケール (2022 年 10 月 24 日月曜日など>に従って<weekday、month、day、year の形式で日付を返します。
    • long: ユーザーのロケール (2022 年 10 月 24 日など> に従って、日付を <月、日、年 の形式で返します。
    • medium: long に似ていますが、省略された月で日付を返します (例:2022 年 10 月 24 日)。
    • short:ユーザーのロケール (10/24/2022 や 24/10/2022 など) に従って、MM/DD/YY または DD/MM/YY の形式で日付を返します。

    他の値が渡された場合、API はデフォルトで medium になります。指定できる値では、大文字と小文字は区別されません。
    表 : 23. 戻り値
    タイプ 説明
    なし

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

    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(文字列日付, 文字列スタイル, 文字列言語)

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

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

    たとえば、このトピックの前半の getDisplayValueLang(String style, String language) の例からの出力を使用すると、 2022 年 10 月 25 日 または 2022 年 10 月 25 日が許容される値です。
    style 文字列 日付形式。
    有効な値：
    • full:ユーザーのロケール (2022 年 10 月 24 日月曜日など>に従って<weekday、month、day、year の形式で日付を返します。
    • long: ユーザーのロケール (2022 年 10 月 24 日など> に従って、日付を <月、日、年 の形式で返します。
    • medium: long に似ていますが、省略された月で日付を返します (例:2022 年 10 月 24 日)。
    • short:ユーザーのロケール (10/24/2022 や 24/10/2022 など) に従って、MM/DD/YY または DD/MM/YY の形式で日付を返します。

    他の値が渡された場合、API はデフォルトで medium になります。指定できる値では、大文字と小文字は区別されません。
    言語 文字列 BCP-47 標準に準拠する言語タグを使用して言語を設定します。たとえば、フランス語の場合は fr 、イギリス英語の場合は en-UK です。使用できる値の完全な一覧については、「 BCP 47 言語コードの一覧」を参照してください。
    表 : 25. 戻り値
    タイプ 説明
    なし

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

    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(文字列 o)

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

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

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

    出力：

    2015-01-01

    スコープ対応

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