GlideTime - スコープ指定

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：7分

    • 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. パラメーター
    名前 タイプ 説明
    形式 文字列 時刻の書式設定に使用する文字列。
    たとえば、現在の時刻が 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 - getDisplayValueInternal()

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

    表 : 7. パラメーター
    名前 タイプ 説明
    なし
    表 : 8. 戻り値
    タイプ 説明
    文字列 現在のユーザーのタイムゾーンでの 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:getHourLocalTime()

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

    表 : 9. パラメーター
    名前 タイプ 説明
    なし
    表 : 10. 戻り値
    タイプ 説明
    番号 ローカルタイムゾーンを使用した時間。

    GlideTime:getHourOfDayLocalTime()

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

    表 : 11. パラメーター
    名前 タイプ 説明
    なし
    表 : 12. 戻り値
    タイプ 説明
    番号 ローカルタイムゾーンを使用した時間。時間数は 24 時間制に基づいています。

    GlideTime:getHourOfDayUTC()

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

    表 : 13. パラメーター
    名前 タイプ 説明
    なし
    表 : 14. 戻り値
    タイプ 説明
    番号 UTC タイムゾーンを使用した時間。時間数は 24 時間制に基づいています。

    GlideTime:getHourUTC()

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

    表 : 15. パラメーター
    名前 タイプ 説明
    なし
    表 : 16. 戻り値
    タイプ 説明
    番号 UTC タイムゾーンを使用した時間。時間数は 12 時間制に基づいています。正午と深夜は 12 ではなく 0 で表されます。

    GlideTime:getMinutesLocalTime()

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

    表 : 17. パラメーター
    名前 タイプ 説明
    なし
    表 : 18. 戻り値
    タイプ 説明
    番号 ローカルタイムゾーンを使用する分数。

    GlideTime - getMinutesUTC()

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

    表 : 19. パラメーター
    名前 タイプ 説明
    なし
    表 : 20. 戻り値
    タイプ 説明
    番号 UTC タイムゾーンを使用した時間単位の分数。

    GlideTime:getSeconds()

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

    表 : 21. パラメーター
    名前 タイプ 説明
    なし
    表 : 22. 戻り値
    タイプ 説明
    番号 秒単位の秒数。

    GlideTime:getValue()

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

    表 : 23. パラメーター
    名前 タイプ 説明
    なし
    表 : 24. 戻り値
    タイプ 説明
    文字列 内部フォーマトおよびシステムタイムゾーンの時間値。 
    var gt = new GlideTime();
gs.info(gt.getValue()); // Internal Time Zone, UTC

    GlideTime:setDisplayValue(文字列 asDisplayed)

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

    表 : 25. パラメーター
    名前 タイプ 説明
    asDisplayed 文字列 現在のユーザーの表示形式とタイムゾーンの時間。パラメーターは、現在のユーザーの優先表示形式 (HH:mm:ss など) を使用して書式設定する必要があります。
    表 : 26. 戻り値
    タイプ 説明
    なし 
    var gt = new GlideTime();
gt.setDisplayValue('01:00:00');   // User Time Zone
gs.info(gt.getDisplayValueInternal()); // User Time Zone

    GlideTime - setValue(文字列 o)

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

    このメソッドに無効なデータが指定された場合、基になる時間は 00:00:00 に設定されます。

    表 : 27. パラメーター
    名前 タイプ 説明
    o 文字列 hh:mm:ss 形式の時間。
    表 : 28. 戻り値
    タイプ 説明
    なし 
    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 オブジェクト値の期間差を取得します。

    表 : 29. パラメーター
    名前 タイプ 説明
    startTime GlideTime 開始値。
    endTime GlideTime 終了値。
    表 : 30. 戻り値
    タイプ 説明
    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());