---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideDate - スコープ指定

# GlideDate - スコープ指定 {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：12分

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

一般的な形式の競合のリストを含む日時入力文字列のガイダンスについては、「 [日付形式のガイドライン](https://servicenow-prod.fluidtopics.net/LqzXHBR~LmafMNQzuPKSdQ#date-and-time-format-guidelines "特定の日付と時刻パターンの文字列シーケンスを使用して、日付形式を指定できます。パターン文字列は、A から Z までの 1 つ以上の大文字と小文字で構成されます。引用符で囲まれたテキストは無視され、代わりに日付出力にコピーされます。")」を参照してください。

## スコープ対象 GlideDate - GlideDate() {#ariaid-title2}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 1. パラメーター]

{#r_ScopedGlideDateGlideDate__table_vy2_525_jq}  

    //Today's date is April 21, 2021
    var gd = new GlideDate();
    gs.info(gd.getValue());

出力：

    2021-04-21

## スコープ対象 GlideDate - getByFormat(文字列 format) {#ariaid-title3}

指定した日付形式で日付を取得します。
{#r_ScopedGlideDateGetByFormat_String__table_vy2_525_jq__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| format | 文字列 | Java [SimpleDateFormat](https://docs.oracle.com/javase/10/docs/api/java/text/SimpleDateFormat.html) を使用した目的の日付形式。たとえば、`"dd-MM-yyyy"` は日、月、年を取得し、`"EEEE"` は曜日を取得します。 |
[表 : 2. パラメーター]

{#r_ScopedGlideDateGetByFormat_String__table_vy2_525_jq} {#r_ScopedGlideDateGetByFormat_String__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 指定した形式の GlideDate オブジェクトの日付値。 |
[表 : 3. 返される内容]

{#r_ScopedGlideDateGetByFormat_String__table_qpt_3f5_jq}  

    var gd = new GlideDate(); 
    gd.setValue('2021-04-21');
    gs.info(gd.getByFormat("dd-MM-yyyy"));

出力：

    21-04-2021

## スコープ対象 GlideDate - getDayOfMonthNoTZ() {#ariaid-title4}

GlideDate オブジェクトに格納された、UTC タイムゾーンで表される日付を取得します。
{#r_SGD-getDayOfMonthNoTZ__table_gdd_z5q_yv__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 4. パラメーター]

{#r_SGD-getDayOfMonthNoTZ__table_gdd_z5q_yv} {#r_SGD-getDayOfMonthNoTZ__table_hdd_z5q_yv__entry__2}

| タイプ | 説明 |
|-|-|
| 数値 | UTC タイムゾーンでの 1 ～ 31 の日付。 |
[表 : 5. 返される内容]

{#r_SGD-getDayOfMonthNoTZ__table_hdd_z5q_yv}  

    //Today's date is 2016-05-13 
    var gd =new GlideDate();
    gs.info(gd.getDayOfMonthNoTZ());

出力：

    13

## スコープ対象 GlideDate - getDisplayValue() {#ariaid-title5}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| none |   |   |
[表 : 6. パラメーター]

{#r_ScopedGlideDateGetDisplayValue__table_vy2_535_jq} {#r_ScopedGlideDateGetDisplayValue__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 現在のユーザーの表示形式とタイムゾーンでの GlideDate オブジェクトに対する日付値。ビジネスルールまたはスクリプトインクルードを設計する際は、このメソッドによって返される値の形式がユーザーによって異なることに注意してください。 |
[表 : 7. 返される内容]

{#r_ScopedGlideDateGetDisplayValue__table_qpt_3f5_jq}  

    var gd = new GlideDate(); 
    gd.setValue('2021-04-21');
    gs.info(gd.getDisplayValue());

出力：

    2021-04-21

## スコープ対象 GlideDate - getDisplayValueInternal() {#ariaid-title6}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| none |   |   |
[表 : 8. パラメーター]

{#r_ScopedGlideDateGetDisplayValueInternal__table_vy2_535_jq} {#r_ScopedGlideDateGetDisplayValueInternal__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 現在のユーザーのタイムゾーンでの GlideDate オブジェクトに対する日付値。 形式：yyyy-MM-dd |
[表 : 9. 返される内容]

{#r_ScopedGlideDateGetDisplayValueInternal__table_qpt_3f5_jq}  

    var gd = new GlideDate(); 
    gs.info(gd.getDisplayValueInternal());

出力：

    2021-04-21

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

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

| 名前 | タイプ | 説明 |
|-|-|-|
| 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 言語コード一覧](https://appmakers.dev/bcp-47-language-codes-list/)」を参照してください。 |
[表 : 10. パラメーター]

{#r_SGD-getDisplayValueLang_S_S__id_a2q_p5w_dwb} {#r_SGD-getDisplayValueLang_S_S__id_wwn_q5w_dwb__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 現在のユーザーのロケールに従って指定されたスタイルと言語の日付。 |
[表 : 11. 返される内容]

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

    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() {#ariaid-title8}

GlideDate オブジェクトに格納された、UTC タイムゾーンで表される月を取得します。
{#r_SGD-getMonthNoTZ__table_az1_3wq_yv__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 12. パラメーター]

{#r_SGD-getMonthNoTZ__table_az1_3wq_yv} {#r_SGD-getMonthNoTZ__table_bz1_3wq_yv__entry__2}

| タイプ | 説明 |
|-|-|
| 数値 | 1 ～ 12 の月の数値。 |
[表 : 13. 返される内容]

{#r_SGD-getMonthNoTZ__table_bz1_3wq_yv}  

    //Today's date is 2016-05-13
    var gd =new GlideDate();
    gs.info(gd.getMonthNoTZ());

出力：

    5

## スコープ対象 GlideDate - getValue() {#ariaid-title9}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| none |   |   |
[表 : 14. パラメーター]

{#r_ScopedGlideDateGetValue__table_vy2_535_jq} {#r_ScopedGlideDateGetValue__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | システムタイムゾーンでの GlideDate オブジェクトの日付値。 形式：yyyy-MM-dd |
[表 : 15. 返される内容]

{#r_ScopedGlideDateGetValue__table_qpt_3f5_jq}  

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

出力：

    2021-04-21

## スコープ対象 GlideDate - getYearNoTZ() {#ariaid-title10}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 16. パラメーター]

{#r_SGD-getYearNoTZ__table_pnp_hxq_yv} {#r_SGD-getYearNoTZ__table_qnp_hxq_yv__entry__2}

| タイプ | 説明 |
|-|-|
| 数値 | 年の数値。 |
[表 : 17. 返される内容]

{#r_SGD-getYearNoTZ__table_qnp_hxq_yv}  

    //Today's date is 2016-05-13
    var gd =new GlideDate();
    gs.info(gd.getYearNoTZ());

出力：

    2016

## スコープ対象 GlideDate - setDisplayValue(文字列 asDisplayed) {#ariaid-title11}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| asDisplayed | 文字列 | 現在のユーザーの表示形式とタイムゾーンでの日付。 形式：現在のユーザーの優先表示形式 (yyyy-MM-dd など) を使用して書式設定される必要があります。 |
[表 : 18. パラメーター]

{#r_ScopedGlideDateSetDisplayValue_String__table_vy2_525_jq} {#r_ScopedGlideDateSetDisplayValue_String__table_qpt_3f5_jq1__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 19. 返される内容]

{#r_ScopedGlideDateSetDisplayValue_String__table_qpt_3f5_jq1}  

    var gd = new GlideDate();
    gd.setDisplayValue("2011-01-01");
    gs.info(gd.getValue());

出力：

    2011-01-01

## スコープ付き GlideDate - setDisplayValueLang(文字列 date, 文字列スタイル) {#ariaid-title12}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| 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` に設定されます。指定できる値では、大文字と小文字は区別されません。 |
[表 : 20. パラメーター]

{#r_SGD-setDisplayValueLang_S_S__id_m14_55w_dwb} {#r_SGD-setDisplayValueLang_S_S__id_xh1_v5w_dwb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 21. 返される内容]

{#r_SGD-setDisplayValueLang_S_S__id_xh1_v5w_dwb}  
次の例は、 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(文字列の日付, 文字列のスタイル, 文字列の言語) {#ariaid-title13}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| 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 言語コード一覧](https://appmakers.dev/bcp-47-language-codes-list/)」を参照してください。 |
[表 : 22. パラメーター]

{#r_SGD-setDisplayValueLang_S_S_S__id_kns_w5w_dwb} {#r_SGD-setDisplayValueLang_S_S_S__id_j5m_x5w_dwb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 23. 返される内容]

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

    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) {#ariaid-title14}

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

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

{#r_ScopedGlideDateSetValue_String__table_vy2_525_jq} {#r_ScopedGlideDateSetValue_String__table_qpt_3f5_jq1__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 25. 返される内容]

{#r_ScopedGlideDateSetValue_String__table_qpt_3f5_jq1}  

    var gd = new GlideDate(); 
    gd.setValue('2015-01-01');
    gs.info(gd.getValue());

出力：

    2015-01-01

## スコープ対象 GlideDate - subtract(GlideDate start, GlideDate end) {#ariaid-title15}

2 つの GlideDate 値の期間差を取得します。
{#r_ScopedGlideDateSubtract_GlideDate_GlideDate__table_vy2_525_jq__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| start | GlideDate | 開始値。 |
| end | GlideDate | 終了値。 |
[表 : 26. パラメーター]

{#r_ScopedGlideDateSubtract_GlideDate_GlideDate__table_vy2_525_jq} {#r_ScopedGlideDateSubtract_GlideDate_GlideDate__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| GlideDuration | 2 つの値の間の期間。 |
[表 : 27. 返される内容]

{#r_ScopedGlideDateSubtract_GlideDate_GlideDate__table_qpt_3f5_jq}  

    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