PHP date() -funktio

PHP Date / Time funktiot

esimerkki

Muotoile paikallinen päivämäärä ja aika, ja palauta muotoiltu päivämäärä merkkijonona：

<?php
// Tulostaa päivän
echo date("l") . "<br>";
// Tulostaa päivän, päivämäärän, kuukauden, vuoden, ajan AM tai PM
echo date("l jS \of F Y h:i:s A");
?>

suorituslause

määritelmä ja käyttötapa

date() -funktio muotoilee paikallisen päivämäärän ja ajan, ja palauttaa muotoillun päivämäärän merkkijonon.

syntaksi

date(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 tekstimuoto (kolme kirjainta)
  • j - kuukauden päivä ilman johtavia nollia (1-31)
  • l（'L' pieni muoto）- viikonpäivän täydellinen tekstimuoto
  • N - viikonpäivän ISO-8601 muodossa (1: Monday[maanantaina], 7: Sunday[sunntaina])
  • S - kuukauden päivän englanninkielinen序数后缀（kaksi kirjainta：st、nd、rd tai th。Käytetään yhdessä kirjaimen j kanssa）
  • w - viikonpäivän numero muodossa (0: Sunday[sunntaina], 6: Saturday[lauantaina])
  • z - vuoden päivämäärä (0-365)
  • W - vuoden viikon numero ISO-8601 muodossa (viikko alkaa Monday[maanantaina])
  • F - kuukauden täydellinen tekstimuoto (January[eneruun] asti December[joulukuun])
  • m - kuukauden numero muodossa (01-12)
  • M - kuukauden lyhyt tekstimuoto (kolme kirjainta)
  • n - kuukauden numero muodossa, ilman johtavia nollia (1-12)
  • t - annetun kuukauden sisältämien päivien määrä
  • L - onko vuosi vuosikierre (vuosikierre: 1, muuten: 0)
  • o - ISO-8601 standardin mukainen vuoden numero
  • Y - vuoden neljän numeron muoto
  • y - vuoden kahden numeron muoto
  • a - pieni muoto: am tai pm
  • A - Isokirjaiminen muoto: AM tai PM
  • B - Swatch Internet Time (000-999)
  • g - 12-tuntinen aikaväli ilman johtuvia nollia (1-12)
  • G - 24-tuntinen aikaväli ilman johtuvia nollia (0-23)
  • h - 12-tuntinen aikaväli, johtuvilla nollilla (01-12)
  • H - 24-tuntinen aikaväli, johtuvilla nollilla (00-23)
  • i - Minuutit, johtuvilla nollilla (00-59)
  • s - Sekunnit, johtuvilla nollilla (00-59)
  • u - Mikrosekunnit (lisätty PHP 5.2.2)
  • e - Aikavyöhykkeen tunniste (esim. UTC, GMT, Atlantic/Azores)
  • I (i isojen kirjaimin) - Onko päivämäärä kesäaikayönä (jos on, 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 lyhenteet (esim. EST, MDT)
  • Z - Aikavyöhykevirhe sekunneissa. UTC-itäisen aikavyöhykkeen virhe 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 -muotoinen päivämäärä (esim.: perjantai, 12 huhtikuuta 2013 12:01:05 +0200)
  • U - Unix-ajan (1. tammikuuta 1970 00:00:00 GMT) kulunut sekuntimäärä

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

  • 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.: perjantai, 12 huhtikuuta 13 15:52:01 +0000)
  • DATE_RFC850 - RFC 850 (esim.: Friday, 12-Apr-13 15:52:01 UTC)
  • DATE_RFC1036 - RFC 1036 (esim.: perjantai, 12 huhtikuuta 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 (alkaen PHP 5.1.3)
  • 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ää kokonaislukuinen Unix aikaleima. Oletuksena on nykyinen paikallinen aika (time()).

Tekninen yksityiskohta

Palautusarvo: Onnistuessaan palauttaa muotoillun päivämäärän merkkijonon, epäonnistuessaan raportoi E_WARNING virhe ja palauttaa FALSE.
PHP versio: 4+
Päivityspäiväkirja:

PHP 5.1.0: Lisätty E_STRICT ja E_NOTICE aikavyöhykevirhe. Voimassa olevan aikaleiman aikaväli 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:sta 19-01-2038:een.

PHP 5.1.1: Lisätty uusi vakio päivämäärä/aika muoto, käytetään määrittämiseen format Parametrit.

PHP Date / Time funktiot