GlideDate - スコープ指定

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：12分

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

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

    スコープ対象 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 - 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()

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

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

    スコープ対象 GlideDate - getDisplayValueInternal()

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

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

    形式：yyyy-MM-dd

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

    スコープ付き GlideDate - getDisplayValueLang(文字列スタイル, 文字列言語)

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

    表 : 10. パラメーター
    名前 タイプ 説明
    style 文字列 日付形式。
    有効な値：
    • full:ユーザーのロケールに従って <平日、月、日、年> の形式で日付を返します (例:2022 年 10 月 24 日月曜日)。
    • long:ユーザーのロケールに従って <月、日、年> の形式で日付を返します (例:2022 年 10 月 24 日)。
    • medium: 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 言語コード一覧」を参照してください。
    表 : 11. 返される内容
    タイプ 説明
    文字列 現在のユーザーのロケールに従って指定されたスタイルと言語の日付。

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

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

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

    出力：

    5

    スコープ対象 GlideDate - getValue()

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

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

    形式：yyyy-MM-dd

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

    スコープ対象 GlideDate - getYearNoTZ()

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

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

    出力：

    2016

    スコープ対象 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 - setDisplayValueLang(文字列 date, 文字列スタイル)

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

    表 : 20. パラメーター
    名前 タイプ 説明
    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:ユーザーのロケールに従って MM/DD/YY または DD/MM/YY の形式で日付を返します (10/24/2022 や 24/10/2022 など)。

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

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

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

    表 : 22. パラメーター
    名前 タイプ 説明
    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:ユーザーのロケールに従って 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 - subtract(GlideDate start, GlideDate end)

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

    表 : 26. パラメーター
    名前 タイプ 説明
    start GlideDate 開始値。
    end GlideDate 終了値。
    表 : 27. 返される内容
    タイプ 説明
    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