pure.util
[ class tree: pure.util ] [ index: pure.util ] [ all elements ]

Class: DATE

Source Location: /package/pure/util/DATE.inc

Class Overview

PURE_Class
   |
   --DATE

日付操作用のスタティックメソッド群を集約するクラスです。


Methods



Class Details

[line 21]
日付操作用のスタティックメソッド群を集約するクラスです。



[ Top ]


Class Methods


static method compareDay [line 212]

static void compareDay( int $year1, int $month1, int $day1, int $year2, int $month2, int $day2)

年月日を比較します。

年月日は全て整数値で指定します。 年月日1の方が過去(年月日2の方が未来)であった場合にはメソッドは < 0 を返します。 年月日1の方が未来(年月日2の方が過去)であった場合にはメソッドは > 0 を返します。 年月日1と年月日2が等しい場合には 0 を返します。

これは以下のようなコーディングに適していることを表します。

  1.  if (DATE::compareDay(2007812007820{
  2.      echo "年月日2の方が未来です";
  3.  }

このメソッドは年月日の範囲の妥当性の判断は行わないことに注意してください。




Tags:

access:  public


Parameters:

int   $year1   年1
int   $month1   月1
int   $day1   日1
int   $year2   年2
int   $month2   月2
int   $day2   日2

[ Top ]

static method compareMonth [line 177]

static void compareMonth( int $year1, int $month1, int $year2, int $month2)

年月を比較します。

年月は全て整数値で指定します。 年月1の方が過去(年月2の方が未来)であった場合にはメソッドは < 0 を返します。 年月1の方が未来(年月2の方が過去)であった場合にはメソッドは > 0 を返します。 年月1と年月2が等しい場合には 0 を返します。

これは以下のようなコーディングに適していることを表します。

  1.  if (DATE::compareDay(2007812007820{
  2.      echo "年月2の方が未来です";
  3.  }

このメソッドは年月の範囲の妥当性の判断は行わないことに注意してください。




Tags:

access:  public


Parameters:

int   $year1   年1
int   $month1   月1
int   $year2   年2
int   $month2   月2

[ Top ]

static method compareYear [line 146]

static void compareYear( int $year1, int $year2)

年を比較します。

年は全て整数値で指定します。 年1の方が過去(年2の方が未来)であった場合にはメソッドは < 0 を返します。 年1の方が未来(年2の方が過去)であった場合にはメソッドは > 0 を返します。 年1と年2が等しい場合には 0 を返します。

これは以下のようなコーディングに適していることを表します。

  1.  if (DATE::compareDay(2007812007820{
  2.      echo "年2の方が未来です";
  3.  }

このメソッドは年の範囲の妥当性の判断は行わないことに注意してください。




Tags:

access:  public


Parameters:

int   $year1   年1
int   $year2   年2

[ Top ]

static method dayOfWeek [line 111]

static void dayOfWeek( int $year, int $month, int $day)

指定の年月日の曜日を求めます。

有効範囲は1583年~3999年の範囲で、日曜日が0、月曜日が1、…土曜日が6で返されます。

なお、処理上は0年から9999年まで受け付けますが内部的にはZeller (ツェラー) の公式で計算されるため有効範囲が定まっています。 Zellerの公式はグレゴリオ暦を前提としているため、ユリウス歴が利用されていた範囲 (1582年より前程度) では計算値が狂ってくることに注意してください。 正確には1582年10月15日以降が有効範囲になります。




Tags:

access:  public


Parameters:

int   $year  
int   $month  
int   $day  

[ Top ]

static method isDate [line 44]

static bool isDate( int $y, int $m, int $d)

日付の範囲が妥当か否かを判定して返します。

日付の範囲はUNIX EPOCHからの経過病数で日時を管理する32bit処理系で扱うことが出来る安全域である1902年から2037年の間です。




Tags:

return:  判定結果
access:  public


Parameters:

int   $y  
int   $m  
int   $d  

[ Top ]

static method isLeapYear [line 29]

static bool isLeapYear( int $year)

指定の年がうるう年か否かを判定して返します。



Tags:

return:  うるう年か否か
access:  public


Parameters:

int   $year  

[ Top ]

static method lastOfMonth [line 78]

static int lastOfMonth( int $year, int $month)

指定の年月の末尾の日を取得します。 範囲外の値を指定した場合にはEIlligalParameterException例外が発生します。



Tags:

return:  最後の日
throws:  EIlligalParameterException パラメータ不正
access:  public


Parameters:

int   $year  
int   $month  

[ Top ]


Documentation generated on Sun, 06 Jan 2008 01:33:10 +0900 by phpDocumentor 1.3.2