틀:그레고리력 날수/설명문서 편집하기

{{설명문서 안내}}
<!-- 여기에 틀에 대한 설명문서를 작성하세요. -->
역산(逆算, proleptic) [[그레고리력]] 1년 1월 1일을 1(첫째 날)로 하여 지정된 날짜 또는 현재 날짜(서버 시간:한국 표준시 기준)가 몇째 날인지를 구합니다. 그레고리력의 4, 100, 400년 단위 윤년 법칙이 반영됩니다.

=== 사용법 ===
<code><nowiki>{{그레고리력 날수|연도|월|일|시|분|초}}</nowiki></code>
*연도, 월, 일을 생략하면 서버 시각(한국 표준시) 기준 현재 날짜가 적용됩니다.
*시, 분, 초를 생략하면 0으로 간주됩니다.
*이 틀은 [[1582년]] 10월 15일 이전의 날짜에 대해서 [[율리우스력]]을 쓰지 않고 [[역산 그레고리력]]([[:en:Proleptic Gregorian calendar|proleptic Gregorian calendar]])을 쓰므로 여기에서 말하는 1년 1월 1일이 율리우스력의 1년 1월 1일과 다르다는 것에 주의해야 합니다.
*연도, 월, 일은 정수만을 입력합니다.
**기원전 해를 입력하려면 0(기원전 1년), -1(기원전 2년) ... 순으로 쓰면 되고 이 결과는 음수로 출력됩니다. (단, 기원전 1년 12월 31일은 0)
**정상 범위를 넘는 월, 일을 입력해도 됩니다. 예를 들어 13월은 다음 해의 1월로, 0일은 이전 달의 마지막 날로 계산됩니다.
*시, 분, 초에는 정수 입력을 권장합니다. 부동소수점 실수나 #expr 함수가 지원하는 계산식을 넣을 수 있으나 예상치 못한 오류가 발생할 수 있으므로 권장하지 않습니다.
**0~23 밖의 시나 0~60 밖의 분, 초는 이전이나 이후로 계산됩니다. 예를 들어 -1시 0분 123초는 전날의 23시 2분 3초로 계산됩니다.
*미디어위키 계산 기능의 한계로 인해 입력 기간은 아래 범위로 제한됩니다. 범위 밖의 범위를 입력하면 정확한 결과가 보장되지 않습니다.
**시분초 입력하지 않는 경우: -22억 8310만 5023년 6월 1일(-833886986576)부터 22억 8310만 5022년 12월 31일(833886985997)까지
**시분초 입력하는 경우: -273만 7907년 12월 28일 0시 0분 0초(-1000000000)부터 273만 7908년 1월 3일 23시 59분 59초(999999999.99999)까지

===사용 예===
{| class="wikitable" style="margin: 1em 2em;"
!style="padding: 0.5em;"|입력||style="padding: 0.5em;"|결과||style="padding: 0.5em;"|비고
|-
|style="padding: 0.5em;"|<code><nowiki>{{그레고리력 날수|0|1|1}}</nowiki></code>||style="padding: 0.5em;"|{{그레고리력 날수|0|1|1}}||style="padding: 0.5em;"|역산 그레고리력 기준 기원전 1년 1월 1일 0시
|-
|style="padding: 0.5em;"|<code><nowiki>{{그레고리력 날수|0|12|31}}</nowiki></code>||style="padding: 0.5em;"|{{그레고리력 날수|0|12|31}}||style="padding: 0.5em;"|&#32;
|-
|style="padding: 0.5em;"|<code><nowiki>{{그레고리력 날수|1|1|1}}</nowiki></code>||style="padding: 0.5em;"|{{그레고리력 날수|1|1|1}}||style="padding: 0.5em;"|&#32;
|-
|style="padding: 0.5em;"|<code><nowiki>{{그레고리력 날수|1582|10|15|12|0|0}}</nowiki></code>||style="padding: 0.5em;"|{{그레고리력 날수|1582|10|15|12|0|0}}||style="padding: 0.5em;"|그레고리력이 실제 처음 시행된 날짜와 시간
|-
|style="padding: 0.5em;"|<code><nowiki>{{그레고리력 날수|2000|1|23}}</nowiki></code>||style="padding: 0.5em;"|{{그레고리력 날수|2000|1|23}}||style="padding: 0.5em;"|0시 0분 0초
|-
|style="padding: 0.5em;"|<code><nowiki>{{그레고리력 날수|2000|1|23|12}}</nowiki></code>||style="padding: 0.5em;"|{{그레고리력 날수|2000|1|23|12}}||style="padding: 0.5em;"|12시 0분 0초
|-
|style="padding: 0.5em;"|<code><nowiki>{{그레고리력 날수|2000|1|23|12|34|56}}</nowiki></code>||style="padding: 0.5em;"|{{그레고리력 날수|2000|1|23|12|34|56}}||style="padding: 0.5em;"|12시 34분 56초
|-
|style="padding: 0.5em;"|<code><nowiki>{{그레고리력 날수}}</nowiki></code>||style="padding: 0.5em;"|{{그레고리력 날수}}||style="padding: 0.5em;"|한국 표준시 기준 현재 날짜
|-
|style="padding: 0.5em;"|<code><nowiki>{{그레고리력 날수|-2737907|12|28|00|00|00}}</nowiki></code>||style="padding: 0.5em;"|{{그레고리력 날수|-2737907|12|28|00|00|00}}||style="padding: 0.5em;"|시분초 있을 경우 결과가 정확한 과거 한계 시점
|-
|style="padding: 0.5em;"|<code><nowiki>{{그레고리력 날수|2737908|01|03|23|59|59}}</nowiki></code>||style="padding: 0.5em;"|{{그레고리력 날수|2737908|01|03|23|59|59}}||style="padding: 0.5em;"|시분초 있을 경우 결과가 정확한 미래 한계 시점
|-
|style="padding: 0.5em;"|<code><nowiki>{{그레고리력 날수|-2283105023|06|01}}</nowiki></code>||style="padding: 0.5em;"|{{그레고리력 날수|-2283105023|06|01}}||style="padding: 0.5em;"|시분초 없을 경우 결과가 정확한 과거 한계 시점
|-
|style="padding: 0.5em;"|<code><nowiki>{{그레고리력 날수|2283105022|12|31}}</nowiki></code>||style="padding: 0.5em;"|{{그레고리력 날수|2283105022|12|31}}||style="padding: 0.5em;"|시분초 없을 경우 결과가 정확한 미래 한계 시점
|}

===기술적인 사항===
*[[세계시|UT]] 기준 동일 시점에서 이 틀의 결과값은 [[율리우스일]](JD)에서 1721424.5를 뺀 값과 같습니다. [[윤초]]는 고려하지 않습니다.
**연월일을 생략했을 때 이 틀은 서버 시각([[한국 표준시]])을 기준으로 하므로 실제 현재 율리우스일과 연동 계산하려면 연월일을 생략하지 않고 수동으로 넣거나 연월일에 각각 <code><nowiki>{{현재년}}</nowiki></code>, <code><nowiki>{{현재월}}</nowiki></code>, <code><nowiki>{{현재일}}</nowiki></code>을 넣어야 합니다.
*시분초 없을 때의 계산 한계 시점이 임의의 수처럼 보이지만, 이는 내부 계산 과정에서 자릿수가 14자리를 초과하지 않는 한계입니다.
*{{틀|율리우스일}}과 연산이 매우 비슷하나 율리우스력 전환 등을 고려하지 않았으므로 조건 분기가 더 적습니다.

===이 틀로 넘겨주는 틀===
*{{틀|Gregorian serial date}}

=== 같이 보기===
*[[그레고리력]]
*{{틀|율리우스일}}
*{{틀|날짜}}

<includeonly>
<!-- 여기에 분류를 넣어주세요. -->
[[분류:날짜 틀|{{문서이름}}]]
[[분류:메타 틀|{{문서이름}}]]
</includeonly>

{{퍼온문서|틀:그레고리력 날수}}