PHP: DateTimeInterface - Manual

DateTimeImmutable や DateTime を引数や戻り値、プロパティの型宣言で使えるようにするために作られたものです。このインターフェイスを実装したクラスをユーザー側で作ることはできません。 DateTimeImmutable::format() や DateTime::format() を通じて、 DateTimeImmutable や DateTime をフォーマットするための共通の定数も、このインターフェイスに定義されています。

/* メソッド */

public diff ( DateTimeInterface


    $targetObject

, bool


    $absolute

= false ): DateInterval

public format ( string


     $format

): string

public getOffset (): int

public getTimestamp (): int

public getTimezone (): DateTimeZone | false

public __wakeup (): void

ISO-8601 と互換性を保つためには、 DateTimeInterface::ISO8601_EXPANDED , DateTimeInterface::ATOM を使うようにしてください。 (ISO8601:2004 section 4.3.3 clause d も参照ください)

DateTimeInterface::diff — ふたつの DateTime オブジェクトの差を返す
DateTimeInterface::format — 指定した書式でフォーマットした日付を返す
DateTimeInterface::getOffset — タイムゾーンのオフセットを返す
DateTimeInterface::getTimestamp — Unix タイムスタンプを取得する
DateTimeInterface::getTimezone — 指定した DateTime に関連するタイムゾーンを返す
DateTime::__wakeup — __wakeup ハンドラ

Improve This Page

bohwaz ¶

1 year ago


    
     Please note that if you are using DATE_RFC7231 format (used in HTTP/1.1), you'll need to change the DateTime object timezone to GMT *before*, or you'll encounter weird results, as this format DOES NOT convert the date to GMT.
     

     

     So if you have a DateTime object using UTC+01:00 as its timezone, you will get a difference of 1 hour between your resulting date string and what should be the "correct" date.
     

     

     Recommended use:
     

     

     
      <?php
      

      $date_gmt
     
     
      = clone
     
     
      $date
     
     
      ;
      

     
     
      $date_gmt
     
     
      ->
     
     
      setTimezone
     
     
      (new
     
     
      \DateTimeZone
     
     
      (
     
     
      'GMT'
     
     
      ));
      

      echo
     
     
      $date_gmt
     
     
      ->
     
     
      format
     
     
      (
     
     
      DATE_RFC7231
     
     
      );
      

     
     
      ?>

＋ add a note

目次

Improve This Page