Funkcja gmdate() w PHP

Funkcje Data / Time w PHP

Przykład

Formatuj datę i czas GMT/UTC, zwracając sformatowaną ciąg daty:

<?php
// Wyświetla dzień tygodnia
echo gmdate("l") . "<br>";
// Wyświetla dzień tygodnia, dzień, miesiąc, rok, czas, porę dnia
echo gmdate("l jS \of F Y h:i:s A");
?>

Przykład uruchomienia

Definicja i użycie

Funkcja gmdate() formatuje datę i czas GMT/UTC, zwracając sformatowaną ciąg daty.

Gramatyka

gmdate(format,timestamp);
Parametr Opis
format

Wymagane. Określa format wyjściowego ciągu daty. Można użyć następujących znaków:

  • d - Dzień miesiąca (od 01 do 31)
  • D - Tekstowa reprezentacja dnia tygodnia (z użyciem trzech liter)
  • j - Dzień miesiąca, bez wstępnego zera (od 1 do 31)
  • l (mała forma 'L') - Pełna reprezentacja tekstowa dnia tygodnia
  • N - Cyfrowa reprezentacja dnia tygodnia w formacie ISO-8601 (1 to poniedziałek, 7 to niedziela)
  • S - Angielski sufix liczby porządkowej dnia miesiąca (2 znaki: st, nd, rd lub th. Używany z 'j')
  • w - Cyfrowa reprezentacja dnia tygodnia (0 to niedziela, 6 to sobota)
  • z - Dzień roku (od 0 do 365)
  • W - Numer tygodnia w roku w formacie cyfrowym zgodnym z ISO-8601 (tydzień zaczyna się od poniedziałku)
  • F - Pełna reprezentacja tekstowa miesiąca (styczeń do grudzień)
  • m - Cyfrowa reprezentacja miesiąca (od 01 do 12)
  • M - Krótka reprezentacja miesiąca (z użyciem trzech liter)
  • n - Cyfrowa reprezentacja miesiąca, bez wstępnego zera (1 do 12)
  • t - Liczba dni w danym miesiącu
  • L - Czy jest rok przestępny (1, jeśli tak, w przeciwnym razie 0)
  • o - Rok cyfrowy zgodny z normą ISO-8601
  • Y - czterocyfrowy rok
  • y - dwucyfrowy rok
  • a - małe litery: am lub pm
  • A - duże litery: 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ża litera 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 ery Unix (1 stycznia 1970 00:00:00 GMT)

Również można używać poniższych zdefiniowanych 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.: Fri, 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łkowitych sekund Unix timestamp. Domyślnie jest to bieżąca lokalna godzina (time()).

Szczegółowe informacje techniczne

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

PHP 5.1.0: Poprawny zakres znacznika czasu wynosi od 13 grudnia 1901 roku 20:45:54 GMT piątek do 19 stycznia 2038 roku 03:14:07 GMT wtorek. W wersjach 5.1.0 i wcześniejszych, w niektórych systemach (np. Windows) znacznik czasu jest ograniczony do zakresu od 01-01-1970 do 19-01-2038.

PHP 5.1.1: Dodane standardowe stałe formatu daty/czasu, używane do określenia format Parametry.

Funkcje Data / Time w PHP