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. パラメーター
    名前 タイプ 説明
    milliseconds 数値 午前 0 時 (UTC) に追加する時間。

    単位：ミリ秒

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

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

    出力:

    16:00:10

    GlideTime - getByFormat(文字列形式)

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

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

    表 : 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 = 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. 返される内容
    タイプ 説明
    文字列 現在のユーザーのタイムゾーンと内部の日時形式 HH:mm:ss での GlideTime オブジェクトに対する時間値。 
    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 タイムゾーンに基づいて分数を返します。

    表 : 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 オブジェクトの時間を内部タイムゾーンで設定します。

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