PHP gmdate() -funktio

esimerkki

Muotoile GMT/UTC päivämäärän ja ajan, ja palauta muotoiltu päivämäärän merkkijono:

<?php
// Tulostaa viikonpäivän
echo gmdate("l") . "<br>";
// Tulostaa viikonpäivän, päivän, kuukauden, vuoden, ajan ja aamun tai iltapäivän
echo gmdate("l jS \of F Y h:i:s A");
?>

suorituslause

määrittely ja käyttö

gmdate() -funktio muotoilee GMT/UTC päivämäärän ja ajan, ja palauttaa muotoillun päivämäärän merkkijonon.

syntaksi

gmdate(format,timestamp);
parametrit kuvaus
format

Välttämätön. Määrittää päivämäärän merkkijonon muodon. Voit käyttää seuraavia merkkejä:

  • d - Kuukauden päivä (01-31)
  • D - Viikonpäivän tekstinen ilmaisu (kolmella kirjaimella)
  • j - Kuukauden päivä ilman johtavia nollia (1-31)
  • l('L' pieni muoto)- Viikonpäivän täydellinen tekstinen ilmaisu
  • N - Viikonpäivän ISO-8601 numeroilmaisu (1 maanantai, 7 sunnuntai)
  • S - Kuukauden päivän englanninkielinen序数后缀(2 kirjainta:st、nd、rd tai th。Käytetään yhdessä j:n kanssa)
  • w - Viikonpäivän numeroilmaisu (0 viikonloppu, 6 lauantai)
  • z - Vuoden päivä numerossa (0-365)
  • W - Vuoden viikon numero ISO-8601 muodossa (viikko alkaa Monday[maanantai]lta)
  • F - Kuukauden täydellinen tekstinen ilmaisu (January[taukokuu] asti December[joulukuu])
  • m - Kuukauden numeroilmaisu (01-12)
  • M - Kuukauden lyhyt tekstinen ilmaisu (kolmella kirjaimella)
  • n - Kuukauden numeroilmaisu ilman johtavia nollia (1-12)
  • t - Annetun kuukauden sisältämien päivien määrä
  • L - Onko se liettorinen vuosi (liettorinen vuosi: 1, muina: 0)
  • o - ISO-8601 standardin mukaiset vuoden numerot
  • Y - Vuosiluku neljällä numerolla
  • y - Vuosiluku kahdella numerolla
  • a - Pienellä kirjaimella esitetty: am tai pm
  • A - Isolla kirjaimella esitetty: AM tai PM
  • B - Swatch Internet Time (000-999)
  • g - 12-tuntinen ajanotto ilman johtuvia nollia (1-12)
  • G - 24-tuntinen ajanotto ilman johtuvia nollia (0-23)
  • h - 12-tuntinen ajanotto, johtuvilla nollilla (01-12)
  • H - 24-tuntinen ajanotto, johtuvilla nollilla (00-23)
  • i - Minuutit, johtuvilla nollilla (00-59)
  • s - Sekunnit, johtuvilla nollilla (00-59)
  • u - Mikrosekuntit (lisätty PHP 5.2.2)
  • e - Aikavyöhykkeen tunniste (esim. UTC, GMT, Atlantic/Azores)
  • I (i ison muodon muoto) - Onko päivämäärä kesäajassa (kesäaikana 1, muuten 0)
  • O - Greenwichin ajan (GMT) erotus, yksikkönä tuntia (esim. +0100)
  • P - Greenwichin ajan (GMT) erotus, yksikkönä tuntia:minuutit (lisätty PHP 5.1.3)
  • T - Aikavyöhykkeen lyhenne (esim. EST, MDT)
  • Z - Aikavyöhykkeen siirtymä sekunneissa. UTC -aikavyöhykkeen siirtymä on negatiivinen (-43200 asti 50400)
  • c - ISO-8601 -standardin mukainen päivämäärä (esim. 2013-05-05T16:34:42+00:00)
  • r - RFC 2822 -muodossa oleva päivämäärä (esim. Fri, 12 Apr 2013 12:01:05 +0200)
  • U - Unix-ajan (January 1 1970 00:00:00 GMT) kulunut sekuntimäärä

Samalla voidaan käyttää seuraavia määritettyjä muuttujia (PHP 5.1.0 alkaen):

  • DATE_ATOM - Atom (esim. 2013-04-12T15:52:01+00:00)
  • DATE_COOKIE - HTTP Cookies (esim. Friday, 12-Apr-13 15:52:01 UTC)
  • DATE_ISO8601 - ISO-8601 (esim. 2013-04-12T15:52:01+0000)
  • DATE_RFC822 - RFC 822 (esim. Fri, 12 Apr 13 15:52:01 +0000)
  • DATE_RFC850 - RFC 850 (esim. Friday, 12-Apr-13 15:52:01 UTC)
  • DATE_RFC1036 - RFC 1036 (esim.: Fri, 12 Apr 13 15:52:01 +0000)
  • DATE_RFC1123 - RFC 1123 (esim.: Fri, 12 Apr 2013 15:52:01 +0000)
  • DATE_RFC2822 - RFC 2822 (Fri, 12 Apr 2013 15:52:01 +0000)
  • DATE_RFC3339 - Sama kuin DATE_ATOM (PHP 5.1.3 alkaen)
  • DATE_RSS - RSS (Fri, 12 Aug 2013 15:52:01 +0000)
  • DATE_W3C - World Wide Web Consortium (esim.: 2013-04-12T15:52:01+00:00)
timestamp Valinnainen. Määrittää kokonaisluvun Unix-aikaleiman. Oletus on nykyinen paikallinen aika (time()).

Tekninen yksityiskohta

Palautusarvo: Onnistuessaan palauttaa muotoillun päivämäärä- ja aikataulun, epäonnistuessaan palauttaa E_WARNING virheen ja FALSE.
PHP versio: 4+
Päivityspäiväkirja:

PHP 5.1.0: Vakioaikaleiman kelvollinen alue on 13. joulukuuta 1901 20:45:54 GMT perjantai 19. tammikuuta 2038 03:14:07 GMT tiistai. 5.1.0 ennen versiot, joissakin järjestelmissä (esim. Windows) aikaleima on rajoitettu 01-01-1970:een 19-01-2038:een.

PHP 5.1.1: Lisätty uusia vakioita päivämäärä/aikaleimalle, jotka käytetään määrittämiseen format Parametrit.