Funkcja date() w PHP

Funkcje data/czas PHP

Przykład

Formatuje lokalną datę i czas oraz zwraca sformatowaną datę jako ciąg znaków:

<?php
// Wyjście dnia
echo date("l") . "<br>";
// Wyjście dnia, daty, miesiąca, roku, czasu AM lub PM
echo date("l jS \of F Y h:i:s A");
?>

Przykład użycia

Definicja i użycie

Funkcja date() formatuje lokalną datę i czas oraz zwraca sformatowaną datę jako ciąg znaków.

Gramatyka

date(format,timestamp);
Parametr Opis
format

Wymagane. Określa format wyjściowego łańcucha daty. Można używać następujących znaków:

  • d - liczba dnia miesiąca (od 01 do 31)
  • D - tekst dnia tygodnia (oznaczony trzema literami)
  • j - liczba dnia miesiąca bez zer wstępnych (od 1 do 31)
  • l (mała forma 'L') - pełny tekst dnia tygodnia
  • N - liczba dnia tygodnia w formacie ISO-8601 (1 to poniedziałek, 7 to niedziela)
  • S - końcówka angielskiego porządku dni miesiąca (2 znaki: st, nd, rd lub th. używane z literą j)
  • w - liczba dnia tygodnia (0 to niedziela, 6 to sobota)
  • z - liczba dnia w roku (od 0 do 365)
  • W - liczba tygodnia w roku w formacie ISO-8601 (tydzień zaczyna się od poniedziałku)
  • F - pełny tekst miesiąca (od stycznia do grudnia)
  • m - liczba miesiąca (od 01 do 12)
  • M - krótki tekst miesiąca (oznaczony trzema literami)
  • n - liczba miesiąca bez zer wstępnych (od 1 do 12)
  • t - liczba dni w danym miesiącu
  • L - czy jest to rok przestępny (1 jeśli tak, w przeciwnym razie 0)
  • o - liczba roczna zgodna z standardem ISO-8601
  • Y - czteroznakowy przedział roku
  • y - dwuznakowy przedział roku
  • a - mała forma oznaczana jako: am lub pm
  • A - w dużej formie oznacza: AM lub PM
  • B - Swatch Internet Time (000 do 999)
  • g - 12-godzinny format, bez wiodącego zera (1 do 12)
  • G - 24-godzinny format, bez wiodącego zera (0 do 23)
  • h - 12-godzinny format, z wiodącym zerem (01 do 12)
  • H - 24-godzinny format, z wiodącym zerem (00 do 23)
  • i - minuty, z wiodącym zerem (00 do 59)
  • s - sekundy, z wiodącym zerem (00 do 59)
  • u - mikrosekundy (dodane w PHP 5.2.2)
  • e - identyfikator strefy czasowej (np. UTC, GMT, Atlantic/Azores)
  • I (duże I) - czy data jest w czasie letnim (jeśli tak, to 1, w przeciwnym razie 0)
  • O - różnica z czasem GMT w formacie godzin (np. +0100)
  • P - różnica z czasem GMT w formacie hours:minutes (dodane w PHP 5.1.3)
  • T - skrót strefy czasowej (np. EST, MDT)
  • Z - przesunięcie strefy czasowej w sekundach. Przesunięcie dla strefy UTC na zachód jest ujemne (-43200 do 50400)
  • c - data w formacie ISO-8601 (np. 2013-05-05T16:34:42+00:00)
  • r - data w formacie RFC 2822 (np. Piątek, 12 Apr 2013 12:01:05 +0200)
  • U - liczba sekund od początku era Unix (1 stycznia 1970 00:00:00 GMT)

Również można używać następujących预先定义owanych stałych (dostępnych od PHP 5.1.0):

  • DATE_ATOM - Atom (np. 2013-04-12T15:52:01+00:00)
  • DATE_COOKIE - HTTP Cookies (np. Piątek, 12-Apr-13 15:52:01 UTC)
  • DATE_ISO8601 - ISO-8601 (np. 2013-04-12T15:52:01+0000)
  • DATE_RFC822 - RFC 822 (np. Piątek, 12 Apr 13 15:52:01 +0000)
  • DATE_RFC850 - RFC 850 (np. Piątek, 12-Apr-13 15:52:01 UTC)
  • DATE_RFC1036 - RFC 1036 (np. Piątek, 12 Apr 13 15:52:01 +0000)
  • DATE_RFC1123 - RFC 1123 (np.: Fri, 12 Apr 2013 15:52:01 +0000)
  • DATE_RFC2822 - RFC 2822 (Fri, 12 Apr 2013 15:52:01 +0000)
  • DATE_RFC3339 - Takie same jak DATE_ATOM (od PHP 5.1.3)
  • DATE_RSS - RSS (Fri, 12 Aug 2013 15:52:01 +0000)
  • DATE_W3C - Wspólnota W3C (np.: 2013-04-12T15:52:01+00:00)
timestamp Opcjonalnie. Określa całkowity czas w sekundach od początku epoki Unix. Domyślnie jest to bieżąca lokalna godzina (time()).

Szczegółowe informacje techniczne

Zwracana wartość: Zwraca sformatowaną ciąg liter, jeśli się powiedzie, w przeciwnym razie zgłasza E_WARNING i zwraca FALSE.
Wersja PHP: 4+
Log aktualizacji:

PHP 5.1.0: Dodano E_STRICT i E_NOTICE błędy strefy czasowej. Właściwy zakres znaczników czasu wynosi od 13 grudnia 1901 roku 20:45:54 GMT piątek do 19 stycznia 2038 roku 03:14:07 GMT wtorek. Wersje 5.1.0 i wcześniejsze, w niektórych systemach (np. Windows), znaczniki czasu są ograniczone do zakresu od 01-01-1970 do 19-01-2038.

PHP 5.1.1: Dodano nowe stałe formatów daty/czasu, używane do określenia format Parametry.

Funkcje data/czas PHP