Class Util

時間関連のユーティリティクラスです.

Namespace: Peach\DT
Located at Peach/DT/Util.php

Methods summary
`public static integer`	# `compareTime( Peach\DT\Time $time1, Peach\DT\Time $time2 )` 2つの時間オブジェクトを比較します. 一つめの引数のほうが後 (未来) の場合は正の値, 前 (過去) の場合は負の値, 同じ場合は 0 を返します. 2つの時間オブジェクトを比較します. 一つめの引数のほうが後 (未来) の場合は正の値, 前 (過去) の場合は負の値, 同じ場合は 0 を返します. このメソッドは, 一つ目の時間オブジェクトの Time::compareTo メソッドを呼び出し二つ目の時間オブジェクトと比較した結果を返します. Parameters `$time1` 1つ目の時間 `$time2` 2つ目の時間 Returns integer 1つ目の時間を2つ目の時間と比較した結果 See `Peach\Util\Comparable::compareTo()`
`public static Peach\DT\Time`	# `oldest( )` 引数に渡された時間オブジェクトの中で最も古いものを返します. 引数に Time 型オブジェクトを羅列するか, Time 型オブジェクトの配列を指定してください. 引数に Time が一つも存在しない場合は NULL を返します. 引数に渡された時間オブジェクトの中で最も古いものを返します. 引数に Time 型オブジェクトを羅列するか, Time 型オブジェクトの配列を指定してください. 引数に Time が一つも存在しない場合は NULL を返します. Returns `Peach\DT\Time` 引数の中で最も古い Time オブジェクト. 引数が空か, Time オブジェクトが含まれていない場合は NULL
`public static Peach\DT\Time`	# `latest( )` 引数に渡された時間オブジェクトの中で最新のものを返します. 引数に Time 型オブジェクトを羅列するか, Time 型オブジェクトの配列を指定してください. 引数に Time が一つも存在しない場合は NULL を返します. 引数に渡された時間オブジェクトの中で最新のものを返します. 引数に Time 型オブジェクトを羅列するか, Time 型オブジェクトの配列を指定してください. 引数に Time が一つも存在しない場合は NULL を返します. Returns `Peach\DT\Time` 引数の中で最新の Time オブジェクト. 引数が空か, Time オブジェクトが含まれていない場合は NULL
`public static boolean`	# `validate( integer $year, integer $month, integer $date, integer $hour = 0, integer $minute = 0, integer $second = 0 )` 引数に指定された年・月・日 (オプションで時・分・秒) の妥当性を検証します. 妥当な組み合わせの場合は TRUE, それ以外は FALSE を返します. 引数に数値以外の型が含まれていた場合, それが数値文字列 (is_numeric() が TRUE を返す) の場合のみ妥当とみなします. 引数に指定された年・月・日 (オプションで時・分・秒) の妥当性を検証します. 妥当な組み合わせの場合は TRUE, それ以外は FALSE を返します. 引数に数値以外の型が含まれていた場合, それが数値文字列 (is_numeric() が TRUE を返す) の場合のみ妥当とみなします. Parameters `$year` 年 `$month` 月 `$date` 日 `$hour` 時 `$minute` 分 `$second` 秒 Returns boolean 組み合わせが妥当な場合に TRUE, それ以外は FALSE
`public static integer`	# `getTimeZoneOffset( )` システム時刻と GMT との時差を, 分単位で返します. システム時刻と GMT との時差を, 分単位で返します. システム時刻が GMT よりも未来の場合 (UTC + 1 以上) は負の値, システム時刻が GMT よりも過去の場合 (UTF - 1 以下) は正の値を返します. 例えばタイムゾーンが "Asia/Tokyo" (+09:00) の場合, 返り値は -540 となります. Returns integer
`public static integer`	# `cleanTimeZoneOffset( integer $offset )` 指定された時差 (分単位) の値が妥当かどうかを調べ, 必要に応じて値を丸めた結果を返します. 世界で実際に使用されているタイムゾーンは UTC-12 から UTC+14 ですが, このメソッドでは -23:45 から +23:45 を妥当なタイムゾーンとみなします. もしも -23:45 以前の時差が指定された場合は -23:45 (1425), +23:45 以降の時差が指定された場合は +23:45 (-1425) に丸めた結果を返します. 指定された時差 (分単位) の値が妥当かどうかを調べ, 必要に応じて値を丸めた結果を返します. 世界で実際に使用されているタイムゾーンは UTC-12 から UTC+14 ですが, このメソッドでは -23:45 から +23:45 を妥当なタイムゾーンとみなします. もしも -23:45 以前の時差が指定された場合は -23:45 (1425), +23:45 以降の時差が指定された場合は +23:45 (-1425) に丸めた結果を返します. もしも NULL が指定された場合は Util::getTimeZoneOffset の結果を返します. それ以外の数値以外の値が指定された場合は, 整数にキャストした値を使用します. Parameters `$offset` Returns integer 引数を -1425 以上 1425 以下に丸めた値