GlideTime - スコープ指定

オーストラリア API リファレンス

Release

australia

ft:locale

ja-JP

ft:publication_title

オーストラリア API リファレンス

ft:clusterId

crapiref

bundleId

crapiref

workflow

Creator

GlideTime - スコープ指定

リリースバージョン: Australia

更新日 2026年03月12日

所要時間：13分

GlideTime API は、GlideTime オブジェクトのインスタンス化や GlideTime フィールドの操作など、GlideTime オブジェクトに対する操作を実行するためのメソッドを提供します。

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

GlideTime:GlideTime()

現在の時刻で GlideTime オブジェクトをインスタンス化します。

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

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

GlideTime:GlideTime(ミリ秒数)

午前 0 時 (UTC) から始まる時間に渡された値を加えた GlideTime オブジェクトをインスタンス化します。

値は、インスタンスが存在するタイムゾーンに合わせて調整されます。たとえば、ユーザーのインスタンスが UTC から -8 時間離れたタイムゾーンにあり、1000 が渡された場合、GlideTime オブジェクトの時間は 16:00:10 (00:00:00 - 8 時間 + 10 秒) になります。

表 : 2. パラメーター
名前	タイプ	説明
ミリ秒	番号	午前 0 時 (UTC) に追加する時間。単位：ミリ秒

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

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

出力:

16:00:10

GlideTime - getByFormat(文字列形式)

指定された形式で時間を返します。

このメソッドに渡すことができる時刻形式の詳細については、「グローバル日付/時刻フィールド形式」を参照してください。これらの値を任意の順序で渡し、ダッシュ、スペース、バックスラッシュ、コロンなどの区切り文字を追加できます。さらに、文字「a」を渡して午前/午後を返すこともできます。

表 : 3. パラメーター
名前	タイプ	説明
format	文字列	時刻の書式設定に使用する文字列。たとえば、現在の時刻が 10:30:20 の場合: hh:mm:ss = 10:30:20 HH = 10 HH –- ss = 10 –- 20 hh a = 午前 10 時 s:m:H ss:mm:hh = 20:30:10 20:30:10 HH/mm/ss = 10/30/20

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

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

出力:

12:00

GlideTime - getDisplayValue()

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

ビジネスルールまたはスクリプトインクルードを設計するときは、このメソッドがユーザーごとに異なる形式で値を返す場合があることに注意してください。

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

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

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

GlideTime:getDisplayValueEx(文字列スタイル)

現在のユーザーのタイムゾーンと指定された形式を使用して時間を返します。

表 : 7. パラメーター
名前	タイプ	説明
style	文字列	時間に使用する形式。有効な値 (大文字と小文字の区別なし): `short`: HH:mm (AM/PM) `medium`:HH:mm:ss (AM/PM) `long`:HH:mm:ss (AM/PM) タイムゾーンの略称 `full`:HH:mm:ss (AM/PM) タイムゾーン時刻は現在のユーザーの言語で返されます。言語によって、時間が 12 時間形式と 24 時間形式のどちらで返されるかが決まります。

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

この例では、現在のユーザーのタイムゾーンと各書式設定オプションを使用して時間を返します。

var gt = new GlideTime();
gs.info(gt.getDisplayValueEx("short"));
gs.info(gt.getDisplayValueEx("medium"));
gs.info(gt.getDisplayValueEx("long"));
gs.info(gt.getDisplayValueEx("full"));

出力:

8:52 AM  //short
8:52:24 AM  //medium
8:52:24 AM PST  //long
8:52:24 AM Pacific Standard Time  //full

GlideTime - getDisplayValueInternal()

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

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

表 : 10. 返される内容
タイプ	説明
文字列	現在のユーザーのタイムゾーンでの GlideTime オブジェクトの時間値と内部時間形式 (HH:mm:ss)。

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

GlideTime - getDisplayValueLang(文字列スタイル, 文字列言語)

現在のユーザーのタイムゾーンと指定された形式および言語を使用して時間を返します。

表 : 11. パラメーター
名前	タイプ	説明
style	文字列	時間に使用する形式。有効な値 (大文字と小文字の区別なし): `short`: HH:mm (AM/PM) `medium`:HH:mm:ss (AM/PM) `long`:HH:mm:ss (AM/PM) タイムゾーンの略称 `full`:HH:mm:ss (AM/PM) タイムゾーン
言語	文字列	オプション。時間を返す言語。BCP 47 言語タグとして指定されます。たとえば、日本語で時刻を返すには、 `タグ ja` を使用します。言語によって、時間が 12 時間形式と 24 時間形式のどちらで返されるかが決まります。たとえば、英語の時刻は 12 時間形式を使用し、日本語の時刻は 24 時間形式を使用します。デフォルト:現在のユーザーの言語。

表 : 12. 返される内容
タイプ	説明
文字列	指定された形式と言語の時刻。

この例では、現在のユーザーのタイムゾーンと各書式設定オプションを使用して、スペイン語で時間を返します。

var gt = new GlideTime();
gs.info(gt.getDisplayValueLang("short", "es"));
gs.info(gt.getDisplayValueLang("medium", "es"));
gs.info(gt.getDisplayValueLang("long", "es"));
gs.info(gt.getDisplayValueLang("full", "es"));

出力:

9:25  //short
9:25:44  //medium
9:25:44 PST  //long
9:25:44 (hora estándar del Pacífico)  //full

GlideTime:getHourLocalTime()

ローカルタイムゾーンを使用して、時間の時間部分を返します。

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

表 : 14. 返される内容
タイプ	説明
番号	ローカルタイムゾーンを使用した時間。

GlideTime:getHourOfDayLocalTime()

ローカルタイムゾーンを使用して、時間の時間部分を返します。時間数は 24 時間制に基づいています。

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

表 : 16. 返される内容
タイプ	説明
番号	ローカルタイムゾーンを使用した時間。時間数は 24 時間制に基づいています。

GlideTime:getHourOfDayUTC()

UTC タイムゾーンを使用して、時間の時間部分を返します。時間数は 24 時間制に基づいています。

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

表 : 18. 返される内容
タイプ	説明
番号	UTC タイムゾーンを使用した時間。時間数は 24 時間制に基づいています。

GlideTime:getHourUTC()

UTC タイムゾーンを使用して、時間の時間部分を返します。時間数は 12 時間制に基づいています。正午と深夜は 12 ではなく 0 で表されます。

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

表 : 20. 返される内容
タイプ	説明
番号	UTC タイムゾーンを使用した時間。時間数は 12 時間制に基づいています。正午と深夜は 12 ではなく 0 で表されます。

GlideTime:getMinutesLocalTime()

ローカルタイムゾーンを使用して分数を返します。

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

表 : 22. 返される内容
タイプ	説明
番号	ローカルタイムゾーンを使用する分数。

GlideTime - getMinutesUTC()

UTC タイムゾーンに基づいて 1 時間単位の分数を返します。

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

表 : 24. 返される内容
タイプ	説明
番号	UTC タイムゾーンを使用した時間単位の分数。

GlideTime:getSeconds()

現在の分数の秒数を返します。

表 : 25. パラメーター
名前	タイプ	説明
なし

表 : 26. 返される内容
タイプ	説明
番号	秒単位の秒数。

GlideTime:getValue()

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

表 : 27. パラメーター
名前	タイプ	説明
なし

表 : 28. 返される内容
タイプ	説明
文字列	内部フォーマトおよびシステムタイムゾーンの時間値。

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

GlideTime:setDisplayValue(文字列 asDisplayed)

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

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

表 : 30. 返される内容
タイプ	説明
なし

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

GlideTime - setDisplayValueEx(文字列 time, 文字列スタイル)

現在のユーザーのタイムゾーンと指定された形式を使用して時間を設定します。

表 : 31. パラメーター
名前	タイプ	説明
time	文字列	時間に設定する値。 getDisplayValueEx() メソッドは、有効な形式で時間を返します。または、時間は次のように書式設定できます。 HH:mm (AM/PM) HH:mm:ss (AM/PM) HH:mm:ss (AM/PM) タイムゾーンの略称 HH:mm:ss (AM/PM) タイムゾーン現在のユーザーの言語によって、12 時間制 (AM/PM) または 24 時間制の時刻の値が受け入れられるかどうかが決まります。たとえば、現在のユーザーの言語が英語の場合、6: `25 PM PST` は有効な値で、 `18:25 PST` は無効です。
style	文字列	時間に使用する形式。指定された time 値と同じ形式を使用する必要があります。有効な値 (大文字と小文字の区別なし): `short`: HH:mm (AM/PM) `medium`:HH:mm:ss (AM/PM) `long`:HH:mm:ss (AM/PM) タイムゾーンの略称 `full`:HH:mm:ss (AM/PM) タイムゾーン

表 : 32. 返される内容
タイプ	説明
なし

この例では、現在のユーザーのタイムゾーンと指定された形式を使用して時間を設定します。

gt = new GlideTime();
gt.setDisplayValueEx("8:25:25 AM", "medium");
gs.info(gt.getDisplayValueEx("full"));

出力:

8:25:25 AM Pacific Standard Time

GlideTime - setDisplayValueLang(String time, String style, String language)

現在のユーザーのタイムゾーンと指定された形式および言語を使用して時間を設定します。

表 : 33. パラメーター
名前	タイプ	説明
time	文字列	時間に設定する値。 getDisplayValueLang() メソッドと getDisplayValueEx() メソッドは、有効な形式で時間を返します。または、時間は次のように書式設定できます。 HH:mm (AM/PM) HH:mm:ss (AM/PM) HH:mm:ss (AM/PM) タイムゾーンの略称 HH:mm:ss (AM/PM) タイムゾーン language パラメーターは、12 時間制 (AM/PM) または 24 時間制の時刻の値を受け入れるかどうかを決定します。たとえば、言語が `en` (英語) の場合、 `6:25 PM PST` は有効な値ですが、 `18:25 PST` はそうではありません。
style	文字列	時間に使用する形式。指定された time 値と同じ形式を使用する必要があります。有効な値 (大文字と小文字の区別なし): `short`: HH:mm (AM/PM) `medium`:HH:mm:ss (AM/PM) `long`:HH:mm:ss (AM/PM) タイムゾーンの略称 `full`:HH:mm:ss (AM/PM) タイムゾーン
言語	文字列	時間を設定する言語。BCP 47 言語タグとして提供されます。たとえば、日本語で時刻を設定するには、「 `ja`」というタグを使用します。

表 : 34. 返される内容
タイプ	説明
なし

この例では、現在のユーザーのタイムゾーンを使用して英語で時間を設定し、スペイン語で取得します。

gt = new GlideTime();
gt.setDisplayValueLang("4:15:00 PM PST", "long", "en");
gs.info(gt.getDisplayValueLang("full", "es"));

出力:

16:15:00 (hora estándar del Pacífico)

GlideTime - setValue(文字列 o)

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

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

表 : 36. 返される内容
タイプ	説明
なし

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

GlideTime - subtract(GlideTime startTime, GlideTime endTime)

2 つの GlideTime オブジェクト値の期間差を取得します。

表 : 37. パラメーター
名前	タイプ	説明
startTime	GlideTime	開始値。
endTime	GlideTime	終了値。

表 : 38. 返される内容
タイプ	説明
GlideDuration	2 つの値の間の期間。

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());