DateTime::format

DateTimeImmutable::format

DateTimeInterface::format

date_format

(PHP 5 >= 5.2.1, PHP 7, PHP 8)

DateTime::format -- DateTimeImmutable::format -- DateTimeInterface::format -- date_format — 주어진 형식에 따라 형식이 지정된 날짜를 반환합니다.

설명

객체 지향 스타일

public DateTime::format(string $format): string

public DateTimeImmutable::format(string $format): string

public DateTimeInterface::format(string $format): string

절차적 스타일

date_format(DateTimeInterface $Object, string $format): string

주어진 형식에 따라 형식이 지정된 날짜를 반환합니다.

매개변수

object

절차 스타일만 해당: date_create()에 의해 반환된 DateTime 객체

format

출력된 날짜 문자열의 형식입니다. 아래 서식 옵션을 참조하세요. 대신 사용할 수 있는 미리 정의된 날짜 상수가 여러 개 있으므로 예를 들어 DATE_RSS에는 형식 문자열 'D, d M Y H:i:s'가 포함됩니다.

format 매개변수 문자열에서 다음 문자가 인식됩니다.

`format` character	설명	반환된 값의 예
Day	---	---
`d`	날짜, 앞에 0이 있는 2자리	`01` to `31`
`D`	하루의 텍스트 표현, 세 글자	`Mon` through `Sun`
`j`	앞에 0이 없는 날짜	`1` to `31`
`l` (lowercase 'L')	요일의 전체 텍스트 표현	`Sunday` through `Saturday`
`N`	요일의 ISO 8601 숫자 표현	`1` (for Monday) through `7` (for Sunday)
`S`	월의 영어 서수 접미사, 2자	`st`, `nd`, `rd` or `th`. Works well with `j`
`w`	요일의 숫자 표현	`0` (for Sunday) through `6` (for Saturday)
`z`	년의 일(0부터 시작)	`0` through `365`
Week	---	---
`W`	ISO 8601 주 번호, 월요일에 시작하는 주	Example: `42` (the 42nd week in the year)
Month	---	---
`F`	1월 또는 3월과 같은 월의 전체 텍스트 표현	`January` through `December`
`m`	선행 0이 있는 월의 숫자 표현	`01` through `12`
`M`	한 달의 짧은 텍스트 표현, 세 글자	`Jan` through `Dec`
`n`	선행 0이 없는 월의 숫자 표현	`1` through `12`
`t`	주어진 달의 일 수	`28` through `31`
Year	---	---
`L`	윤년인지 아닌지	`1` if it is a leap year, `0` otherwise.
`o`	ISO 8601 주 번호 매기기 연도. ISO 주 번호(`W`)가 이전 연도 또는 다음 연도에 속하는 경우 해당 연도가 대신 사용된다는 점을 제외하면 `Y`와 동일한 값을 갖습니다.	Examples: `1999` or `2003`
`Y`	연도의 전체 숫자 표현, 4자리	Examples: `1999` or `2003`
`y`	연도를 나타내는 두 자리 숫자	Examples: `99` or `03`
Time	---	---
`a`	소문자 Ante meridiem 및 Post meridiem	`am` or `pm`
`A`	대문자 Ante meridiem 및 Post meridiem	`AM` or `PM`
`B`	견본 인터넷 시간	`000` through `999`
`g`	앞에 0이 없는 12시간 형식의 시간	`1` through `12`
`G`	앞에 0이 없는 24시간 형식의 시간 형식	`0` through `23`
`h`	앞에 0이 있는 12시간 형식의 시간 형식	`01` through `12`
`H`	앞에 0이 있는 24시간 형식의 시간	`00` through `23`
`i`	앞에 0이 있는 분	`00` to `59`
`s`	앞에 0이 있는 초	`00` through `59`
`u`	마이크로초. date()는 int 매개변수를 취하기 때문에 항상 `000000`을 생성하지만 DateTime::format()은 DateTime이 마이크로초로 생성된 경우 마이크로초를 지원합니다.	Example: `654321`
`v`	밀리초. `u`와 동일한 참고 사항이 적용됩니다.	Example: `654`
Timezone	---	---
`e`	시간대 식별자	Examples: `UTC`, `GMT`, `Atlantic/Azores`
`I` (capital i)	날짜가 일광 절약 시간인지 여부	`1` if Daylight Saving Time, `0` otherwise.
`O`	시와 분 사이에 콜론이 없는 그리니치 시간(GMT)과의 차이	Example: `+0200`
`P`	시와 분 사이에 콜론이 있는 그리니치 시간(GMT)과의 차이	Example: `+02:00`
`p`	`P`와 동일하지만 `+00:00` 대신 `Z`를 반환합니다.	Example: `+02:00`
`T`	시간대 약어(알고 있는 경우) 그렇지 않으면 GMT 오프셋입니다.	Examples: `EST`, `MDT`, `+05`
`Z`	초 단위의 시간대 오프셋입니다. UTC 서쪽 시간대의 오프셋은 항상 음수이고 UTC 동쪽 시간대의 오프셋은 항상 양수입니다.	`-43200` through `50400`
Full Date/Time	---	---
`c`	ISO 8601 날짜	2004-02-12T15:19:21+00:00
`r`	» RFC 2822 형식 날짜	Example: `Thu, 21 Dec 2000 16:01:07 +0200`
`U`	Unix Epoch 이후 초(1970년 1월 1일 00:00:00 GMT)	See also time()

형식 문자열에서 인식할 수 없는 문자는 있는 그대로 인쇄됩니다. Z 형식은 gmdate()를 사용할 때 항상 0을 반환합니다.

메모: 이 함수는 int 타임스탬프만 허용하므로 u 형식 문자는 date_create()로 생성된 사용자 기반 타임스탬프와 함께 date_format() 함수를 사용할 때만 유용합니다.

반환 값

성공하면 형식이 지정된 날짜 문자열을 반환합니다.

변경 로그

버전	설명
8.0.0	이 버전 이전에는 실패 시 `false`가 반환되었습니다.
8.0.0	형식 문자 `p`가 추가되었습니다.

Examples

예제 #1 DateTime::format() 예제