DateTime::getOffset

DateTimeImmutable::getOffset

DateTimeInterface::getOffset

date_offset_get

(PHP 5 >= 5.2.1, PHP 7, PHP 8)

DateTime::getOffset -- DateTimeImmutable::getOffset -- DateTimeInterface::getOffset -- date_offset_getタイムゾーンのオフセットを返す

説明

オブジェクト指向型

public DateTime::getOffset(): int
public DateTimeImmutable::getOffset(): int
public DateTimeInterface::getOffset(): int

手続き型

タイムゾーンのオフセットを返します。

パラメータ

object

手続き型のみ: date_create() が返す DateTime オブジェクト

戻り値

成功した場合には UTC からのタイムゾーンオフセット秒数、

変更履歴

バージョン 説明
8.0.0 これより前のバージョンでは、失敗時に false を返していました。

例1 DateTime::getOffset() の例

オブジェクト指向型

<?php
$winter 
= new DateTime('2010-12-21', new DateTimeZone('America/New_York'));
$summer = new DateTime('2008-06-21', new DateTimeZone('America/New_York'));

echo 
$winter->getOffset() . "\n";
echo 
$summer->getOffset() . "\n";
?>

手続き型

<?php
$winter 
date_create('2010-12-21'timezone_open('America/New_York'));
$summer date_create('2008-06-21'timezone_open('America/New_York'));

echo 
date_offset_get($winter) . "\n";
echo 
date_offset_get($summer) . "\n";
?>

上の例の出力は以下となります。

-18000
-14400

Note: -18000 = -5 hours, -14400 = -4 hours.

関連キーワード:  getOffset, オフセット, DateTime, date, int, DateTimeInterface, public, 手続き, offset, DateTimeImmutable