GlideDate - グローバル

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む14読むのに数分

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

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

    GlideDate - getByFormat(文字列 format)

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

    表 : 1. パラメーター
    名前 タイプ 説明
    format 文字列 Java SimpleDateFormat を使用した目的の日付形式。たとえば、"dd-MM-yyyy" は日、月、年を取得し、"EEEE" は曜日を取得します。
    表 : 2. 返される内容
    タイプ 説明
    文字列 指定した形式の 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 タイムゾーンで表される日付を取得します。

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

    出力：

    13

    スコープ対応

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

    GlideDate - getDisplayValue()

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

    表 : 5. パラメーター
    名前 タイプ 説明
    none
    表 : 6. 返される内容
    タイプ 説明
    文字列 現在のユーザーの表示形式とタイムゾーンでの GlideDate オブジェクトに対する日付値。ビジネスルールまたはスクリプトインクルードを設計する際は、このメソッドによって返される値の形式がユーザーによって異なることに注意してください。 
    var gd = new GlideDate(); 
gd.setValue('2021-04-21');
gs.info(gd.getDisplayValue());
    出力： 
    2021-04-21

    スコープ対応

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

    GlideDate - getDisplayValueInternal()

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

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

    形式：yyyy-MM-dd

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

    スコープ対応

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

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

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

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

    他の値が渡された場合、API はデフォルトで medium に設定されます。受け入れられる値は大文字と小文字を区別しません。
    表 : 10. 返される内容
    タイプ 説明
    文字列 現在のユーザーのロケールに適した形式での、指定されたスタイルでの日付の文字列表現。

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

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

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

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

    他の値が渡された場合、API はデフォルトで medium に設定されます。受け入れられる値は大文字と小文字を区別しません。
    language 文字列 指定された言語値に従って日付を返します。BCP-47 標準に準拠する言語タグを受け入れます。たとえば、フランス語の場合は fr 、イギリス英語の場合は en-UK です。受け入れられる値の完全な一覧については、「 BCP 47 言語コードの一覧」を参照してください。
    表 : 12. 返される内容
    タイプ 説明
    文字列 現在のユーザーのロケールに従って指定されたスタイルと言語での日付。

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

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

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

    出力：

    5

    スコープ対応

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

    GlideDate - getYearNoTZ()

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

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

    出力：

    2016

    スコープ対応

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

    GlideDate - GlideDate()

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

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

    GlideDate - setDisplayValue(文字列 asDisplayed)

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

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

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

    出力：

    2011-01-01

    スコープ対応

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

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

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

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

    たとえば、このトピックで前述した getDisplayValueLang(文字列スタイル、文字列言語) の例からの出力を使用すると、2022 年 10 月 25 日または 25.10.2022 が受け入れられます。
    style 文字列 日付形式。
    有効な値：
    • full:ユーザーのロケール (2022 年 10 月 24 日月曜日など) に従って、<平日、月、日、年> の形式で日付を返します。
    • long:ユーザーのロケール (2022 年 10 月 24 日など) に従って、<月、日、年> の形式で日付を返します。
    • 中: Long に似ていますが、日付に省略された月を返します (例: 2022 年 10 月 24 日)。
    • short:ユーザーのロケールに応じて、MM/DD/YY または DD/MM/YY の形式で日付を返します (たとえば、10/24/2022 または 24/10/2022)。

    他の値が渡された場合、API はデフォルトで medium に設定されます。受け入れられる値は大文字と小文字を区別しません。
    表 : 21. 返される内容
    タイプ 説明
    なし

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

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

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

    たとえば、このトピックで前述した getDisplayValueLang(文字列スタイル、文字列言語) の例からの出力を使用すると、2022 年 10 月 25 日または 25.10.2022 が受け入れられます。
    style 文字列 日付形式。
    有効な値：
    • full:ユーザーのロケール (2022 年 10 月 24 日月曜日など) に従って、<平日、月、日、年> の形式で日付を返します。
    • long:ユーザーのロケール (2022 年 10 月 24 日など) に従って、<月、日、年> の形式で日付を返します。
    • 中: Long に似ていますが、日付に省略された月を返します (例: 2022 年 10 月 24 日)。
    • short:ユーザーのロケールに応じて、MM/DD/YY または DD/MM/YY の形式で日付を返します (たとえば、10/24/2022 または 24/10/2022)。

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

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

    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 オブジェクトの日付を取得します。

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

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

    出力：

    2015-01-01

    スコープ対応

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