PHP.mk документација

DateTimeInterface::format

Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.

datetime.format.php PHP.net прокси Преводот се освежува
Оригинал на PHP.net
Патека datetime.format.php Локална патека за оваа страница.
Извор php.net/manual/en Оригиналниот HTML се реупотребува и локално се стилизира.
Режим Прокси + превод во позадина Кодовите, табелите и белешките остануваат читливи во истиот тек.
DateTimeInterface::format

Референца за `datetime.format.php` со подобрена типографија и навигација.

datetime.format.php

DateTimeInterface::format

DateTimeImmutable::format

DateTime::format

date_format

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

DateTimeInterface::format -- DateTimeImmutable::format -- DateTime::format -- date_formatВраќа датум форматиран според дадениот формат

= NULL

Напиши целосна ознака на елемент

public DateTimeInterface::format(string $format): string
public DateTimeImmutable::format(string $format): string
public DateTime::format(string $format): string

Процедурален стил

Враќа датум форматиран според дадениот формат.

Параметри

object

објектот како свој прв аргумент. DateTime Само процедурален стил: А date_create()

format

Форматот на прикажаниот датум string. Погледнете ги опциите за форматирање подолу. Исто така постојат неколку претходно дефинирани константи за датум кои можат да се користат наместо тоа, така на пример DATE_RSS ја содржи низата за форматирање 'D, d M Y H:i:s'.

Следниве знаци се препознаваат во format низата за параметри
format character = NULL Пример вратени вредности
Ден --- ---
d Ден од месецот, 2 цифри со водечки нули 01 to 31
D Текстуална репрезентација на ден, три букви Mon through Sun
j Ден од месецот без водечки нули 1 to 31
l (мали букви 'L') Целосна текстуална репрезентација на денот во неделата Sunday through Saturday
N ISO 8601 нумеричка репрезентација на денот во неделата 1 (за Понеделник) до 7 (за Недела)
S Англиски ординален суфикс за денот од месецот, 2 знаци st, nd, rd or th. Работи добро со j
w Нумеричка репрезентација на денот во неделата 0 Нумеричка претстава на денот во неделата 6 (за Недела) до
z Денот од годината (почнувајќи од 0) 0 through 365
(за Сабота) --- ---
W ISO 8601 број на неделата во годината, неделите започнуваат во понеделник Пример: 42 (42-та недела во годината)
(за 46-тата недела од годината што започнува со Понеделник) --- ---
F Целосна текстуална репрезентација на месец, како јануари или март January through December
m Нумеричка репрезентација на месец, со водечки нули 01 through 12
M Краток текстуален приказ на месец, три букви Jan through Dec
n Нумерички приказ на месец, без водечки нули 1 through 12
t Број на денови во дадениот месец 28 through 31
(за Декември) --- ---
L Дали е престапна година 1 ако е престапна година, 0 otherwise.
o ISO 8601 година според бројот на неделата. Ова ја има истата вредност како Y, освен што ако бројот на ISO неделата (W) припаѓа на претходната или следната година, наместо тоа се користи таа година. Примери: 1999 or 2003
X Проширен целосен нумерички приказ на година, најмалку 4 цифри, со - за години п.н.е., и + за години н.е. Примери: -0055, +0787, +1999, +10191
x Проширен целосен нумерички приказ ако е потребно, или стандарден целосен нумерички приказ ако е можно (како Y). Најмалку четири цифри. Годините п.н.е. се претходат со -. Years beyond (and including) 10000 се претходат со +. Примери: -0055, 0787, 1999, +10191
Y Целосен нумерички приказ на година, најмалку 4 цифри, со - за години п.н.е. Примери: -0055, 0787, 1999, 2003, 10191
y Двоцифрен приказ на година Примери: 99 or 03
Време --- ---
a Мали букви предпладне и попладне am or pm
A Големи букви предпладне и попладне AM or PM
B Swatch Интернет време 000 through 999
g 12-часовен формат на час без водечки нули 1 through 12
G 24-часовен формат на час без водечки нули 0 through 23
h 12-часовен формат на час со водечки нули 01 through 12
H 24-часовен формат на час со водечки нули 00 through 23
i Минути со водечки нули 00 to 59
s Секунди со водечки нули 00 through 59
u Микросекунди. Имајте предвид дека date() Формат прифатен од 000000 бидејќи зема int како микросекунди бидејќи зема - Враќа датум форматиран според дадениот формат параметар, додека DateTimeInterface поддржува микросекунди ако објект од типот Пример: 654321
v Милисекунди. Истото правило важи како за u. Пример: 654
Временска зона --- ---
e Идентификатор на временска зона Примери: UTC, GMT, Atlantic/Azores
I (големо i) Дали датумот е во летна сезона или не 1 ако е летна сезона, 0 otherwise.
O Разлика до Гриничко време (GMT) без двоеточие помеѓу часови и минути Пример: +0200
P Разлика до Гриничко време (GMT) со двоеточие помеѓу часови и минути Пример: +02:00
p Излезниот интерфејс за IPv6 мултикаст пакети. P, но враќа Z наместо +00:00 (достапно од PHP 8.0.0) Примери: Z or +02:00
T Скратено име на временската зона, ако е познато; инаку GMT поместување. Примери: EST, MDT, +05
Z Поместување на временската зона во секунди. Поместувањето за временските зони западно од UTC е секогаш негативно, а за оние источно од UTC е секогаш позитивно. -43200 through 50400
Целосен датум/време --- ---
c ISO 8601 датум. Компатибилен само со не-проширениот формат (до година 9999). Поновите датуми ќе резултираат со невалиден стринг. За понови датуми и проширен формат, видете x and X. 2004-02-12T15:19:21+00:00
r » RFC 2822/» RFC 5322 форматиран датум Пример: Thu, 21 Dec 2000 16:01:07 +0200
U Секунди од Unix епохата (1 јануари 1970 00:00:00 GMT) Види исто така time()

Непрепознаените знаци во стринг за формат ќе бидат испечатени како што се. На Z форматот секогаш ќе враќа 0 кога се користи gmdate().

Забелешка:

Бидејќи оваа функција прифаќа само int временски ознаки, на u знакот за формат е корисен само кога се користи date_format() функцијата со временски ознаки базирани на корисник креирани со date_create().

Вратени вредности

Враќа форматиран стринг со датум при успех.

Дневник на промени

Верзија = NULL
8.2.0 Знаците за формат X and x се додадени.
8.0.0 Знакот за формат p е додадена.

Примери

Пример #1 - Враќа датум форматиран според дадениот формат example

Напиши целосна ознака на елемент

<?php
$date
= new DateTimeImmutable('2000-01-01');
echo
$date->format('Y-m-d H:i:s');
?>

Пример #1 Пример што покажува затворачка ознака што го опфаќа последниот нов ред

2000-01-01 00:00:00

Процедурален стил

<?php
$date
= date_create('2000-01-01');
echo
date_format($date, 'Y-m-d H:i:s');
?>

Пример #1 Пример што покажува затворачка ознака што го опфаќа последниот нов ред

2000-01-01 00:00:00

Пример #2 Повеќе примери

<?php
// set the default timezone to use.
date_default_timezone_set('UTC');

// now
$date = new DateTimeImmutable();

// Prints something like: Wednesday
echo $date->format('l'), "\n";

// Prints something like: Wednesday 19th of October 2022 08:40:48 AM
echo $date->format('l jS \o\f F Y h:i:s A'), "\n";

/* use the constants in the format parameter */
// prints something like: Wed, 19 Oct 2022 08:40:48 +0000
echo $date->format(DateTimeInterface::RFC2822), "\n";
?>

беше креиран со микросекунди.

Пример #3 Ескејпирање знаци при форматирање

<?php
$date
= new DateTimeImmutable();

// prints something like: Wednesday the 19th
echo $date->format('l \t\h\e jS');
?>

Форматирање Форматирај го времето/датумот GMT/UTC според локалните поставки За форматирање на датуми на други јазици, - Враќа датум форматиран според дадениот формат.

Белешки

Овој метод не користи локали. Целиот излез е на англиски.

Белешки од корисници 2 забелешки

jurchiks101 на gmail точка com
пред 1 година
If you want to get the week of year + year of said week, you need to use `format('o-W'), otherwise you can stumble into a non-obvious gotcha (unless you RTFM and memorised it, that is).
Using `Y` instead of `o` can result in incorrect year values in the case of the first or last week of the year (depending on if January 4th falls into said week or not), such as the first week of 2025 between 2024-12-30 and 2025-01-05 - `(new DateTime('2024-12-30'))->format('o-W')` will return the correct value of `2025-01` (as per ISO-8601 definition of week of year), while `format('Y-W')` will return `2024-01`.
Because of this, I would personally recommend avoiding using week of year anywhere unless absolutely necessary, as it is easy to make this mistake and never realise it.
jpachta на NOSPAM точка centrum точка cz
пред 5 месеци
Ad Escaping characters while formatting

To escape special characters, such as `\n`, `\t`, etc., is needed usage of multiple escaping to avoid expanding the formatting key or special character itself.

In my case I needed a new line sequence `\n` to be printed in the output as is i.e. as a plain text with backslash and letter n.

In the example bellow there are used letters `Y`, `n`, `W` that without escaping are recognized as format character representing full year (`Y`), month number(`n`) and week number (`W`).

<?php
/* Escaping new line special character \n to be a plain text */

// Now
$now = new DateTime();

// Prints something like: 2025\n41
echo $now->format('Y\\\\\nW');

/* Test of various escaping sequences */

// List of formats in single quotes
$formats = [
    'YnW',  // 20251041
    'Y\nW',  // 2025n41
    'Y\\nW',  // 2025n41
    'Y\\\nW',  // 2025\1041
    'Y\\\\nW',  // 2025\1041
    'Y\\\\\nW',  // 2025\n41
    'Y\\\\\\nW',  // 2025\n41
    'Y\\\\\\\nW',  // 2025\\1041
    'Y\\\\\\\\nW',  // 2025\\1041
    'Y\\\\\\\\\nW',  // 2025\\n41
    'Y\\\\\\\\\\nW',  // 2025\\n41
];
foreach($formats as $key => $format){
  echo PHP_EOL . $key . '. format: '. var_export($format, true) ."\t".' output: '. $now->format($format);
}
?>
Prints something like:
0. format: 'YnW'  output: 20251041
1. format: 'Y\\nW'  output: 2025n41
2. format: 'Y\\nW'  output: 2025n41
3. format: 'Y\\\\nW'  output: 2025\1041
4. format: 'Y\\\\nW'  output: 2025\1041
5. format: 'Y\\\\\\nW'  output: 2025\n41
6. format: 'Y\\\\\\nW'  output: 2025\n41
7. format: 'Y\\\\\\\\nW'  output: 2025\\1041
8. format: 'Y\\\\\\\\nW'  output: 2025\\1041
9. format: 'Y\\\\\\\\\\nW'  output: 2025\\n41
10. format: 'Y\\\\\\\\\\nW'  output: 2025\\n41
Навигација

Прелистувај сродни теми и функции.

На оваа страница

Автоматски outline од активната документација.

Насловите ќе се појават тука по вчитување.

Попрегледно читање

Примерите, changelog табелите и user notes се визуелно издвоени за да не се губат во долгата содржина.

Брз совет Користи го outline-от Скокни директно на главните секции од активната страница.
Извор Оригиналниот линк останува достапен Кога ти треба целосен upstream context, отвори го PHP.net во нов tab.