# Dátum- és időformátum testreszabása

> Hogyan állítod be a dátumok és időpontok megjelenését a honlapon, a formátumkarakterek jelentése és példák.

A honlapon megjelenő dátumok és időpontok (például egy bejegyzés közzétételi ideje) formátumát te döntheted el. A beállítás az egész honlapra érvényes.

## Hol állíthatod

Nyisd meg a **Beállítások → Általános** oldalt. A **Dátumformátum** és az **Időformátum** sorban kész lehetőségek közül választhatsz, vagy az **Egyéni** mezőbe saját formátumot írhatsz. A mező alatti **Előnézet** azonnal mutatja az eredményt.

![Az Általános beállítások a dátum- és időformátummal](./kepek/tartalom-datum-ido-beallitasok.webp)

*Az Általános beállítások a dátum- és időformátummal* (https://minta-bolt.hu/wp-admin/options-general.php)

A képen a **Dátumformátum** és az **Időformátum** sor látszik. Az egyéni mezőben álló karaktersor a formátum, mellette az előnézet mutatja a végeredményt. Az oldal alján a **A hét első napja** mezőben azt is megadhatod, hogy a naptárak melyik napon kezdődjenek.

## Hogyan épül fel a formátum

A formátum betűkből álló karaktersor, és minden betű a dátum vagy az idő egy részét jelenti. Az írásjelek (vessző, pont, kötőjel) változatlanul megjelennek.

Például az `l, F j, Y` formátum ilyen dátumot ad: „Friday, September 24, 2004” (angol nyelvű honlapon). Ebben:

- `l` a nap teljes neve (kisbetűs L);
- `F` a hónap teljes neve;
- `j` a hónap napja;
- `Y` az év négy számjeggyel (a kisbetűs `y` csak az utolsó kettőt adja).

A karakterek a PHP nyelv közös jelölései, mert a WordPress is ebben készült. Magyar honlapon a hónapok és napok nevei magyarul jelennek meg.

### Gyakori karakterek

| Karakter | Jelentés | Példa |
|---|---|---|
| `d` | A nap, számmal, kezdő nullával | 01 és 31 között |
| `j` | A nap, számmal, kezdő nulla nélkül | 1 és 31 között |
| `l` | A hét napjának teljes neve | hétfő, vasárnap |
| `D` | A hét napjának rövid neve | hétf, vas |
| `m` | A hónap száma, kezdő nullával | 01 és 12 között |
| `n` | A hónap száma, kezdő nulla nélkül | 1 és 12 között |
| `F` | A hónap teljes neve | január, december |
| `M` | A hónap rövid neve | jan, dec |
| `Y` | Az év négy számjeggyel | 1999, 2003 |
| `y` | Az év két számjeggyel | 99, 03 |
| `a` | Délelőtt vagy délután, kisbetűvel | de, du |
| `A` | Délelőtt vagy délután, nagybetűvel | DE, DU |
| `g` | Óra, 12 órás, kezdő nulla nélkül | 1 és 12 között |
| `h` | Óra, 12 órás, kezdő nullával | 01 és 12 között |
| `G` | Óra, 24 órás, kezdő nulla nélkül | 0 és 23 között |
| `H` | Óra, 24 órás, kezdő nullával | 00 és 23 között |
| `i` | Perc, kezdő nullával | 00 és 59 között |
| `s` | Másodperc, kezdő nullával | 00 és 59 között |
| `T` | Az időzóna rövidítése | CET |
| `c` | Teljes dátum és idő (ISO 8601) | 2004-02-12T15:19:21+00:00 |
| `r` | Teljes dátum és idő (RFC 2822) | Thu, 21 Dec 2000 16:01:07 +0200 |
| `U` | Unix időbélyeg, a másodpercek száma 1970. január 1. óta | 1455880176 |

A `S` karakter az angol sorszámrag (st, nd, th), magyar honlapon nincs rá szükség.

### Példák

| Formátum | Eredmény (angol példa) |
|---|---|
| `F j, Y g:i a` | November 6, 2010 12:50 am |
| `F j, Y` | November 6, 2010 |
| `F, Y` | November, 2010 |
| `g:i a` | 12:50 am |
| `g:i:s a` | 12:50:48 am |
| `M j, Y @ G:i` | Nov 6, 2010 @ 0:50 |
| `Y/m/d \a\t g:i A` | 2010/11/06 at 12:50 AM |
| `Y/m/d g:i:s A` | 2010/11/06 12:50:48 AM |
| `Y/m/d` | 2010/11/06 |

Magyaros példa: az `Y. F j.` formátum ezt adja: „2026. november 2.”, a `H:i` pedig ezt: „11:55”.

## Betűk kiírása szövegként

Néhány betűnek nincs jelentése a formátumban, ilyenkor az a betű egyszerűen megjelenik. Ez a jövőben megváltozhat, ezért a szövegként kiírandó betűk elé mindig tegyél fordított törtvonalat (`\`). A `\o\f` például az „of” szót írja ki betűről betűre:

```text
l jS \o\f F Y
```

Ez az angol példában így jelenik meg: „Saturday 25th of February 2017”.

## Fejlesztőknek

A téma és a bővítmények sablonjaiban a dátum- és időfüggvények a formátumot paraméterként is megkapják, és ilyenkor felülírják az Általános beállításokat. A `the_time( 'l, F jS, Y' )` hívás például „Posted on Friday, September 24th, 2004” alakú eredményt ad. A formátum honosításához (hónapok és napok nevének fordításához) a `wp_date()` függvény való, ami a PHP `date()` függvényével azonosan működik, de az oldal nyelvén ír. Ezek a témák és bővítmények fejlesztői feladatai, a honlap tulajdonosának a beállítások oldala elég.