---
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


---

# GlideTime - スコープ指定

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

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

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

## GlideTime - GlideTime() {#ariaid-title2}

現在の時間で GlideTime オブジェクトをインスタンス化します。
{#r_ScopedGlideTimeGlideTime__table_cxr_tsb_2r__entry__3}

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

{#r_ScopedGlideTimeGlideTime__table_cxr_tsb_2r}  

    var gt = new GlideTime(); 
    gs.info(gt.getDisplayValue());

## GlideTime - GlideTime (ミリ秒数) {#ariaid-title3}

午前 0 時 (UTC) から始まる時刻と渡された値を使用して、GlideTime オブジェクトをインスタンス化します。
値は、インスタンスがあるタイムゾーンに合わせて調整されます。たとえば、ユーザーのインスタンスが UTC から -8 時間のタイムゾーンにあり、1000 が渡された場合、GlideTime オブジェクトの時間は 16:00:10 (00:00:00 - 8 時間 + 10 秒) になります。
{#r_ScopedGlideTimeGlideTime_Number__table_vy2_525_jq__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| milliseconds | 数値 | 午前 0 時 (UTC) に追加する時間。 単位：ミリ秒 |
[表 : 2. パラメーター]

{#r_ScopedGlideTimeGlideTime_Number__table_vy2_525_jq}  
この例では、午前 0 時 (UTC) に 10 秒を追加し、インスタンスが存在するタイムゾーンに合わせて調整しています。この場合、UTC から -8 時間です。

    var gt = new GlideTime(10000); 
    gs.info(gt.getDisplayValue());

出力:

    16:00:10

## GlideTime - getByFormat(文字列形式) {#ariaid-title4}

指定された形式で時間を返します。
このメソッドに渡すことができる時刻形式の詳細については、「 [グローバル日付と時刻フィールドの形式](https://www.servicenow.com/docs/access?context=r_FormatDateAndTimeFields&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)」を参照してください。これらの値は任意の順序で渡すことができ、ダッシュ、スペース、バックスラッシュ、コロンなどのセパレーターを追加できます。さらに、文字「a」を渡して am/pm を返すこともできます。
{#r_ScopedGlideTimeGetByFormat_String__table_vy2_525_jq__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| format | 文字列 | 時間を書式設定するために使用する文字列。 たとえば、現在の時刻が 10:30:20 の場合、次のようになります。 * hh:mm:ss = 10:30:20 * HH = 10 * HH --- ss = 10 --- 20 * hh a = 10 AM * s:m:H ss:mm:hh = 20:30:10 20:30:10 * HH:mm:ss.SSSZ = 10:30:20.000+0000 * HH/mm/ss = 10/30/20 {#r_ScopedGlideTimeGetByFormat_String__ul_cdw_4zy_jkb} |
[表 : 3. パラメーター]

{#r_ScopedGlideTimeGetByFormat_String__table_vy2_525_jq} {#r_ScopedGlideTimeGetByFormat_String__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 指定された形式の時間。 |
[表 : 4. 返される内容]

{#r_ScopedGlideTimeGetByFormat_String__table_qpt_3f5_jq}  

    var gt = new GlideTime(); 
    gt.setValue('12:00:00');
    gs.info(gt.getByFormat("HH:mm"));

出力:

    12:00

## GlideTime - getDisplayValue() {#ariaid-title5}

現在のユーザーの表示形式とタイムゾーンでの時間を取得します。
ビジネスルールまたはスクリプトインクルードを設計する際は、このメソッドによって返される値の形式がユーザーによって異なることに注意してください。
{#r_ScopedGlideTimeGetDisplayValue__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideTimeGetDisplayValue__table_vy2_525_jq} {#r_ScopedGlideTimeGetDisplayValue__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | ユーザーの形式とタイムゾーンでの時間。 |
[表 : 6. 返される内容]

{#r_ScopedGlideTimeGetDisplayValue__table_qpt_3f5_jq}  

    var gt = new GlideTime();
    gt.setDisplayValue("12:00:00"); // User Time Zone
    gs.info(gt.getDisplayValue()); // User Time Zone

## GlideTime - getDisplayValueInternal() {#ariaid-title6}

現在のユーザーのタイムゾーンと内部形式 (HH:mm:ss) での表示値を取得します。
{#r_ScopedGlideTimeGetDisplayValueInternal__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideTimeGetDisplayValueInternal__table_vy2_525_jq} {#r_ScopedGlideTimeGetDisplayValueInternal__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 現在のユーザーのタイムゾーンと内部の日時形式 HH:mm:ss での GlideTime オブジェクトに対する時間値。 |
[表 : 8. 返される内容]

{#r_ScopedGlideTimeGetDisplayValueInternal__table_qpt_3f5_jq}  

    var gt = new GlideTime();
    gt.setValue("01:00:00"); //Internal Time Zone , UTC
    gs.info(gt.getDisplayValueInternal()); //User Time Zone

## GlideTime - getHourLocalTime() {#ariaid-title7}

ローカルタイムゾーンを使用して時間の部分を返します。
{#r_SGT-getHourLocalTime__table_pwr_c2d_kw__entry__3}

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

{#r_SGT-getHourLocalTime__table_pwr_c2d_kw} {#r_SGT-getHourLocalTime__table_qwr_c2d_kw__entry__2}

| タイプ | 説明 |
|-|-|
| 数値 | ローカルタイムゾーンを使用する時間。 |
[表 : 10. 返される内容]

{#r_SGT-getHourLocalTime__table_qwr_c2d_kw}

## GlideTime - getHourOfDayLocalTime() {#ariaid-title8}

ローカルタイムゾーンを使用して時間の部分を返します。時間数は 24 時間制です。
{#r_SGT-getHourOfDayLocalTime__table_lrw_4dd_kw__entry__3}

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

{#r_SGT-getHourOfDayLocalTime__table_lrw_4dd_kw} {#r_SGT-getHourOfDayLocalTime__table_mrw_4dd_kw__entry__2}

| タイプ | 説明 |
|-|-|
| 数値 | ローカルタイムゾーンを使用する時間。時間数は 24 時間制です。 |
[表 : 12. 返される内容]

{#r_SGT-getHourOfDayLocalTime__table_mrw_4dd_kw}

## GlideTime - getHourOfDayUTC() {#ariaid-title9}

UTC タイムゾーンを使用して時間の部分を返します。時間数は 24 時間制です。
{#r_SGT-getHourOfDayUTC__table_bv5_zxc_kw__entry__3}

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

{#r_SGT-getHourOfDayUTC__table_bv5_zxc_kw} {#r_SGT-getHourOfDayUTC__table_cv5_zxc_kw__entry__2}

| タイプ | 説明 |
|-|-|
| 数値 | UTC タイムゾーンを使用する時間。時間数は 24 時間制です。 |
[表 : 14. 返される内容]

{#r_SGT-getHourOfDayUTC__table_cv5_zxc_kw}

## GlideTime - getHourUTC() {#ariaid-title10}

UTC タイムゾーンを使用して時間の部分を返します。時間数は 12 時間制です。正午と深夜は 12 ではなく 0 で表されます。
{#r_SGT-getHourUTC__table_cfh_nyc_kw__entry__3}

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

{#r_SGT-getHourUTC__table_cfh_nyc_kw} {#r_SGT-getHourUTC__table_dfh_nyc_kw__entry__2}

| タイプ | 説明 |
|-|-|
| 数値 | UTC タイムゾーンを使用する時間。時間数は 12 時間制です。正午と深夜は 12 ではなく 0 で表されます。 |
[表 : 16. 返される内容]

{#r_SGT-getHourUTC__table_dfh_nyc_kw}

## GlideTime - getMinutesLocalTime() {#ariaid-title11}

ローカルタイムゾーンを使用して分数を返します。
{#r_SGT-getMinutesLocalTime__table_gx3_q2d_kw__entry__3}

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

{#r_SGT-getMinutesLocalTime__table_gx3_q2d_kw} {#r_SGT-getMinutesLocalTime__table_hx3_q2d_kw__entry__2}

| タイプ | 説明 |
|-|-|
| 数値 | ローカルタイムゾーンを使用した分数。 |
[表 : 18. 返される内容]

{#r_SGT-getMinutesLocalTime__table_hx3_q2d_kw}

## GlideTime - getMinutesUTC() {#ariaid-title12}

UTC タイムゾーンに基づいて分数を返します。
{#r_SGT-getMinutesUTC__table_qvr_xcd_kw__entry__3}

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

{#r_SGT-getMinutesUTC__table_qvr_xcd_kw} {#r_SGT-getMinutesUTC__table_rvr_xcd_kw__entry__2}

| タイプ | 説明 |
|-|-|
| 数値 | UTC タイムゾーンを使用する時間の分数を返します。 |
[表 : 20. 返される内容]

{#r_SGT-getMinutesUTC__table_rvr_xcd_kw}

## GlideTime - getSeconds() {#ariaid-title13}

現在の分の秒数を返します。
{#r_SGT-getSeconds__table_dkh_1fd_kw__entry__3}

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

{#r_SGT-getSeconds__table_dkh_1fd_kw} {#r_SGT-getSeconds__table_ekh_1fd_kw__entry__2}

| タイプ | 説明 |
|-|-|
| 数値 | 分の秒数を返します。 |
[表 : 22. 返される内容]

{#r_SGT-getSeconds__table_ekh_1fd_kw}

## GlideTime - getValue() {#ariaid-title14}

GlideTime オブジェクトによってデータベースに格納された時間値を内部形式 HH:mm:ss およびシステムタイムゾーンで取得します。
{#r_ScopedGlideTimeGetValue__table_vy2_525_jq__entry__3}

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

{#r_ScopedGlideTimeGetValue__table_vy2_525_jq} {#r_ScopedGlideTimeGetValue__table_qpt_3f5_jq__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 内部形式とシステムタイムゾーンでの時間値。 |
[表 : 24. 返される内容]

{#r_ScopedGlideTimeGetValue__table_qpt_3f5_jq}  

    var gt = new GlideTime();
    gs.info(gt.getValue()); // Internal Time Zone, UTC

## GlideTime - setDisplayValue(文字列 asDisplayed) {#ariaid-title15}

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

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

{#r_ScopedGlideTimeSetDisplayValue_String__table_vy2_525_jq} {#r_ScopedGlideTimeSetDisplayValue_String__table_qpt_3f5_jq1__entry__2}

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

{#r_ScopedGlideTimeSetDisplayValue_String__table_qpt_3f5_jq1}  

    var gt = new GlideTime();
    gt.setDisplayValue('01:00:00');   // User Time Zone
    gs.info(gt.getDisplayValueInternal()); // User Time Zone

## GlideTime - setValue(文字列 o) {#ariaid-title16}

GlideTime オブジェクトの時間を内部タイムゾーンで設定します。
{#r_ScopedGlideTimeSetValue_String__table_vy2_525_jq__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| o | 文字列 | hh:mm:ss 形式の時間。 |
[表 : 27. パラメーター]

{#r_ScopedGlideTimeSetValue_String__table_vy2_525_jq} {#r_ScopedGlideTimeSetValue_String__table_qpt_3f5_jq1__entry__2}

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

{#r_ScopedGlideTimeSetValue_String__table_qpt_3f5_jq1}  

    var gt = new GlideTime();
    gt.setValue('01:00:00');  //Internal Time Zone, UTC
    gs.info("time is "+ gt.getByFormat('hh:mm:ss'));

## GlideTime - 減算 (GlideTime 開始時間, GlideTime 終了時間) {#ariaid-title17}

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

| 名前 | タイプ | 説明 |
|-|-|-|
| startTime | GlideTime | 開始値。 |
| endTime | GlideTime | 終了値。 |
[表 : 29. パラメーター]

{#r_ScopedGlideTimeSubtract_GlideTime_GlideTime__table_vy2_525_jq} {#r_ScopedGlideTimeSubtract_GlideTime_GlideTime__table_qpt_3f5_jq__entry__2}

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

{#r_ScopedGlideTimeSubtract_GlideTime_GlideTime__table_qpt_3f5_jq}  

    var gd1 = new GlideTime(); 
    gd1.setDisplayValue("09:00:00"); 
    var gd2 = new GlideTime(); 
    gd2.setDisplayValue("09:10:00"); 
     
    var dur = GlideDate.subtract(gd1, gd2); //the difference between gdt1 and gdt2 
    gs.info(dur.getDisplayValue());