mirror of
https://github.com/php/doc-ja.git
synced 2026-03-24 15:12:22 +01:00
196 lines
5.7 KiB
XML
196 lines
5.7 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- $Revision$ -->
|
|
<!-- EN-Revision: 3a8c3e77df070a046c9d5b56b68926ca2d7e5ee3 Maintainer: takagi Status: ready -->
|
|
|
|
<refentry xml:id="datetimezone.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
|
<refnamediv>
|
|
<refname>DateTimeZone::__construct</refname>
|
|
<refname>timezone_open</refname>
|
|
<refpurpose>新しい DateTimeZone オブジェクトを作成する</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsect1 role="description">
|
|
&reftitle.description;
|
|
<para>&style.oop;</para>
|
|
<constructorsynopsis role="DateTimeZone">
|
|
<modifier>public</modifier> <methodname>DateTimeZone::__construct</methodname>
|
|
<methodparam><type>string</type><parameter>timezone</parameter></methodparam>
|
|
</constructorsynopsis>
|
|
<para>&style.procedural;</para>
|
|
<methodsynopsis>
|
|
<type class="union"><type>DateTimeZone</type><type>false</type></type><methodname>timezone_open</methodname>
|
|
<methodparam><type>string</type><parameter>timezone</parameter></methodparam>
|
|
</methodsynopsis>
|
|
<para>
|
|
新しい DateTimeZone オブジェクトを作成します。
|
|
</para>
|
|
<para>
|
|
DateTimeZone オブジェクトは、
|
|
3つの異なるタイムゾーンルールへのアクセスを提供します。
|
|
ひとつは
|
|
UTC からのオフセット (type <literal>1</literal>),
|
|
もうひとつはタイムゾーンの省略形 (type
|
|
<literal>2</literal>),
|
|
そして IANA タイムゾーンデータベースで公開されている
|
|
<link linkend="timezones">タイムゾーン名</link>
|
|
(type <literal>3</literal>) です。
|
|
</para>
|
|
<para>
|
|
DateTimeZone オブジェクトは、
|
|
<classname>DateTime</classname> や
|
|
<classname>DateTimeImmutable</classname> に設定できます。
|
|
こうすることで、
|
|
ローカルのタイムゾーンとしてカプセル化された、
|
|
タイムゾーンを表示させることができます。
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="parameters">
|
|
&reftitle.parameters;
|
|
<para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><parameter>timezone</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
サポートする<link linkend="timezones">タイムゾーン名</link>
|
|
のいずれかや、
|
|
オフセット値 (+0200)、
|
|
またはタイムゾーンの省略名(BST)。
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="returnvalues">
|
|
&reftitle.returnvalues;
|
|
<para>
|
|
成功した場合に <classname>DateTimeZone</classname> を返します。
|
|
&return.falseforfailure.style.procedural;
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="errors">
|
|
&reftitle.errors;
|
|
<para>
|
|
指定されたタイムゾーンが有効なタイムゾーンとして認識できない場合、
|
|
<exceptionname>DateInvalidTimeZoneException</exceptionname>
|
|
をスローします。PHP 8.3 より前のバージョンでは、
|
|
<exceptionname>Exception</exceptionname> をスローしていました。
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="changelog">
|
|
&reftitle.changelog;
|
|
<para>
|
|
<informaltable>
|
|
<tgroup cols="2">
|
|
<thead>
|
|
<row>
|
|
<entry>&Version;</entry>
|
|
<entry>&Description;</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
<row>
|
|
<entry>8.3.0</entry>
|
|
<entry>
|
|
無効な値を指定した場合、
|
|
一般的な <exceptionname>Exception</exceptionname>
|
|
ではなく、<exceptionname>DateInvalidTimeZoneException</exceptionname>
|
|
がスローされるようになりました。
|
|
</entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</informaltable>
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="examples">
|
|
&reftitle.examples;
|
|
<para>
|
|
<example>
|
|
<title>DateTimeZone を作成し、DateTimeImmutable に設定する</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
$d = new DateTimeImmutable("2022-06-02 15:44:48 UTC");
|
|
|
|
$timezones = [ 'Europe/London', 'GMT+04:45', '-06:00', 'CEST' ];
|
|
|
|
foreach ($timezones as $tz) {
|
|
$tzo = new DateTimeZone($tz);
|
|
|
|
$local = $d->setTimezone($tzo);
|
|
echo $local->format(DateTimeInterface::RFC2822 . ' — e') . "\n";
|
|
}
|
|
]]>
|
|
</programlisting>
|
|
&example.outputs;
|
|
<screen>
|
|
<![CDATA[
|
|
Thu, 02 Jun 2022 16:44:48 +0100 — Europe/London
|
|
Thu, 02 Jun 2022 20:29:48 +0445 — +04:45
|
|
Thu, 02 Jun 2022 09:44:48 -0600 — -06:00
|
|
Thu, 02 Jun 2022 17:44:48 +0200 — CEST
|
|
]]>
|
|
</screen>
|
|
</example>
|
|
</para>
|
|
|
|
<para>
|
|
<example>
|
|
<title><classname>DateTimeZone</classname> のインスタンスを作成する際のエラー処理</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
// エラー処理は、例外をキャッチすることで行います
|
|
$timezones = array('Europe/London', 'Mars/Phobos', 'Jupiter/Europa');
|
|
|
|
foreach ($timezones as $tz) {
|
|
try {
|
|
$mars = new DateTimeZone($tz);
|
|
echo $mars->getName() . "\n";
|
|
} catch(Exception $e) {
|
|
echo $e->getMessage() . "\n";
|
|
}
|
|
}
|
|
]]>
|
|
</programlisting>
|
|
&example.outputs;
|
|
<screen>
|
|
<![CDATA[
|
|
Europe/London
|
|
DateTimeZone::__construct() [datetimezone.--construct]: Unknown or bad timezone (Mars/Phobos)
|
|
DateTimeZone::__construct() [datetimezone.--construct]: Unknown or bad timezone (Jupiter/Europa)
|
|
]]>
|
|
</screen>
|
|
</example>
|
|
</para>
|
|
</refsect1>
|
|
|
|
</refentry>
|
|
<!-- Keep this comment at the end of the file
|
|
Local variables:
|
|
mode: sgml
|
|
sgml-omittag:t
|
|
sgml-shorttag:t
|
|
sgml-minimize-attributes:nil
|
|
sgml-always-quote-attributes:t
|
|
sgml-indent-step:1
|
|
sgml-indent-data:t
|
|
indent-tabs-mode:nil
|
|
sgml-parent-document:nil
|
|
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
|
|
sgml-exposed-tags:nil
|
|
sgml-local-catalogs:nil
|
|
sgml-local-ecat-files:nil
|
|
End:
|
|
vim600: syn=xml fen fdm=syntax fdl=2 si
|
|
vim: et tw=78 syn=sgml
|
|
vi: ts=1 sw=1
|
|
-->
|