English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

tutorial básico do PHP

tutorial avançado do PHP

PHP & MySQL

manual de referência PHP

uso e exemplo da função date_format() do PHP

PHP Date & Time Functions Manual

a função date_format() retorna uma data formatada com base no formato especificado

definição e uso

esta função éDateTime :: format()alias da função. Ela aceita um objeto DateTime e uma string de formato (representando a data necessária)/formato_de_tempo) como parâmetro, define o formato do objeto de acordo com o formato especificado e retorna o resultado.

sintaxe

date_format($date_time_object, $format)

parâmetro

número ordinalparâmetros e descrição
1

date_time_object (obrigatório)

Este é o objeto DateTime que precisa ser formatado.

2

format (obrigatório)

Esta é a string que representa o formato desejado.

retorno

A função date_format() do PHP retorna uma string de data formatada

versão do PHP

Esta função foi introduzida no PHP versão5.2.1introduzido no PHP 5.2.0 e disponível em todas as versões mais recentes.

Exemplo Online

Aqui está um exemplo de tentativa, estamos criando um objeto DateTime e formatando-o-

<?php
   //criar um objeto DateTime
   $date_time_Obj = date_create("25-09-1989");
   //formatação_de_data/tempo_objeto
   $format = date_format($date_time_Obj, "y"-d-m");
   print("yy-dd-Formato mm: " . $format); 
?>
Test to see‹/›

Resultados de Saída

yy-dd-Formato mm: 89-25-09

Exemplo Online

A seguir, um exemplo define os formatos de data e hora do objeto DateTime-

<?php
   $dateString = '"11-06-2012 12:50:41 GMT';
   $dateTimeObj = date_create($dateString);
   $date = date_format($dateTimeObj, 'd-m-y');
   print("Data: " . $date); 
   print("\n");
   $time = date_format($dateTimeObj, 'H:i:s');
   print("Hora: " . $time); 
?>
Test to see‹/›

Resultados de Saída

Data: 11-06-12
Hora: 12:50:41

Exemplo Online

A seguir, um exemplo demonstra alguns formatos válidos de string no PHP-

<?php
   $dateTimeObj = date_create("11-06-2019 12:50:41 GMT");
   print("y-m-Data no formato d: " . date_format($dateTimeObj, 'Y-m-d'));
   print("\n");
   print("d/m/Data no formato y: " . date_format($dateTimeObj, 'd/m/y'));
   print("\n");
   print("Y-m-d H:i:s Data no formato: " . date_format($dateTimeObj, 'Y-m-d H:i:s
   print("\n");
   print("Data no formato G:i:A: " . date_format($dateTimeObj, 'G-i-A'));
?>
Test to see‹/›

Resultados de Saída

y-m-Data no formato d: 2019-06-11
d/m/Data no formato y: 11/06/19
Y-m-Data no formato d H:i:s: 2019-06-11 12:50:41
Data no formato G:i:A: 12-50-PM

Exemplo Online

A seguir, um exemplo de uso da função date_format() para criar uma nova data-

<?php
   $dateSrc = '"2015-04-19 12:50 GMT';
   $dateTime = date_create($dateSrc);;
   # Agora usar date_format() para definir uma nova data;
   date_format($dateTime, "2000-12-12");
   
   echo "Nova data formatada para " . $dateTime->format("Y"}-m-d\TH:i:s\Z");
   echo "<br>";
   # Usar a segunda função.
   $dateTime = new DateTime($dateSrc);
   $dateTime->setData( 1999, 10, 12);
   
   echo "Nova data formatada para " . $dateTime->format("Y"}-m-d\TH:i:s\Z");
?>
Test to see‹/›

This produces the following output-

New formatted date for 2005-04-19T12:50:00Z
New formatted date for 1999-10-12T12:50:00Z

Format string

Some characters have predefined meanings, you can use them to create format strings, they are:

  • a - "am" or "pm"

  • A - "AM" or "PM"

  • d - Day, two-digit, if less than two digits, fill in zeros in front; such as: "01" to "31"

  • D - Day of the week, three English letters; such as: "Fri"

  • F - Month, full English name; such as: "January"

  • h - 12 Hour in 24-hour clock format; such as: "01" to "12"

  • H - 24 Hour in 12-hour clock format; such as: "00" to "23"

  • g - 12 Hour in 12-hour clock format, if less than two digits, do not fill in zeros; such as: "1" to "12"

  • G - 24 Hour in 12-hour clock format, if less than two digits, do not fill in zeros; such as: "0" to "23"

  • i - Minutes; such as: "00" to "59"

  • j - Day, two-digit, if less than two digits, do not fill in zeros; such as: "1" to "31"

  • l - Day of the week, full English name; such as: "Friday"

  • m - Month, two-digit, if less than two digits, fill in zeros in front; such as: "01" to "12"

  • n - Month, two-digit, if less than two digits, do not fill in zeros; such as: "1" to "12"

  • M - Month, three English letters; such as: "Jan"

  • s - Seconds; such as: "00" to "59"

  • S - Add English ordinal suffix, two English letters; such as: "th", "nd"

  • t - Number of days in the specified month; such as: "28" to "31"

  • w - Numeric day of the week, such as: "0" (Sunday) to "6" (Saturday)

  • Y - Year, four-digit; such as: "1999"

  • y - Year, two-digit; such as: "99"

  • z - Day of the year; such as: "0" to "365"

  • U - Total seconds since the Unix epoch (Greenwich Mean Time1970 year1月1day 00:00:00)

  • e  - Time zone identifier (for example: UTC, Atlantic/Azores)

  • I  - (大写i)-Is the date daylight saving time (if it is daylight saving time, it is1,otherwise 0)

  • O - The difference in hours from Greenwich Mean Time (GMT)+0100)

  • T - PHP machine's time zone setting (for example: EST, MDT)

  • Z - Time zone offset (in seconds). The offset to the west of UTC is negative, and the offset to the east of UTC is positive (-43200 to43200)

  • c - ISO-8601Date (for example2004-02-12T15:19:21 + 00:00)

  • r - RFC 2822Formatted date (for example, Thu,20000年12月21日16:01:07 +0200)

PHP Date & Time Functions Manual