View source for Template:Sefirat HaOmer/doc

{{#if:{{{1|}}}||{{Documentation subpage}}}}
This template gives the current ''[[Sefirat HaOmer]]'' count. It indirectly makes use of the template {{tl|Current hour offset in time zone}}, so that it will show the proper count based on your chosen [[time zone]]. See below for the currently supported time zones.

==Usage==
===Behavior outside the period of ''Sefirat HaOmer''===
The template returns the string {{Pre|None}} outside the period of ''Sefirat HaOmer.''
===Default===
{{Pre|{{((}}Sefirat HaOmer{{))}}}}
Without parameters, the template returns the ''Sefirat HaOmer'' ''(Sefirah)'' count based on UTC (which is the server's time zone). The output is a number between 1 and 49.
===Full===
{{Pre|{{((}}Sefirat HaOmer[{{!}}full{{=}}''yes'']{{))}}}}
With the parameter <code>full=''yes''</code>, the template returns a phrase describing the complete ''Sefirah'' count for the day, based on the customary ''sefirah'' count found in the ([[Ashkenazi]]) ''[[siddur]].''  For example, for Iyar 18 ([[Lag BaOmer]]), the template would return: '''33 days, making 5 weeks and 5 days'''.

===With time zone abbreviation===
{{Pre|{{((}}Sefirat HaOmer[{{!}}full{{=}}''yes''][{{!}}tz{{=}}''time_zone''][{{!}}erev{{=}}''erev'']{{))}}}}
:('<code>[...]</code>' means 'optional', do not include the square brackets when using this template)
where
*''time_zone'' is the desired time zone abbreviation (see below and also the [[list of time zone abbreviations]]);<br />
*''erev'' is an optional parameter to force the Hebrew calendar date to advance at 18:00 (6:00 pm) local time. See below.
*Capability in similar templates to use the code <code>dst</code> to disable automatic daylight saving time adjustment was not included in this template. This template uses {{tl|Daylight saving in time zone}} to automatically adjust the offset according to [[daylight saving time]] (DST), if applicable. If you wish to suppress daylight saving time adjustment in a time zone that otherwise uses it (like in Arizona or Saskatchewan), please use the <code>offset</code> parameter instead.

===With time offset===
{{Pre|{{((}}Sefirat HaOmer{{!}}offset{{=}}''offset''[{{!}}full{{=}}''yes''][{{!}}erev{{=}}''erev'']{{))}}}}
*''offset'' is the time offset from [[UTC]]/[[GMT]] in hours; see map below. Non-integer offsets are valid. Template cannot accommodate DST when using ''offset.'' When <code>offset</code> is present, any time zone abbreviation is ignored.<br />
*''erev'' is an optional parameter to force the Hebrew calendar date to advance at 18:00 (6:00 pm) local time. See below.

===''erev'' parameter: Hebrew dates begin the evening before===
The MediaWiki software, and therefore this template, normally calculate date conversions using conventional midnight-to-midnight days. For example, this template would return the Hebrew calendar date ''1 Elul 5773'' for the entire Gregorian day of ''7 August 2013.''

However, Hebrew calendar dates actually run from sundown to sundown. Thus ''1 Elul 5773'' actually begins at sundown on ''6 August,'' while ''2 Elul'' begins at sundown on ''7 August.''  To approximate this behavior, the parameter <code>erev</code> forces the template to advance the Hebrew calendar date at 18:00 (6:00 pm) in the time zone selected. Thus, at 6:00 pm on ''7 August,'' the template would advance the Hebrew calendar date to ''2 Elul.'' (The page might need to be purged.)

:In this template, the required format for this parameter is <code>erev=''erev''</code>.

===Date===
{{Pre|{{((}}Sefirat HaOmer{{!}}''Hebrew calendar month''{{!}}''Hebrew calendar day of month''{{))}}}}
*Passing the parameters of a Hebrew calendar date (month and day) returns the count for that Hebrew calendar date, or "None" if the date does not fall within the period of the count. Other parameters are ignored in this case.

==Supported time zones==
Currently the following time zones are supported:
{| class="wikitable"
|-
! colspan="2" | {{nowrap|[[File:Snow flake icon.png|24px|alt=SDT&nbsp;-|link=Standard time|Standard time abbreviation]]&nbsp;Abbreviations&nbsp;[[File:Crystal sun.png|24px|alt=-&nbsp;DST|link=Daylight saving time|Daylight saving time abbreviation]]}}
! Name
! colspan="2" | {{nowrap|[[File:Snow flake icon.png|24px|alt=SDT&nbsp;-|link=Standard time|Standard time offset]]&nbsp;{{Purge|Offset}}&nbsp;[[File:Crystal sun.png|24px|alt=-&nbsp;DST|link=Daylight saving time|Daylight saving time offset]]}}
! Notes
|-
| colspan="2" | '''HST'''
| Hawaii Standard Time
| colspan="2" | UTC'''−10''':00
| rowspan="9" | 
DST is not observed in Hawaii. It is not observed in Arizona, except in the Navajo nation, it is not observed in Sonora, and it is not observed in Saskatchewan, except in Lloydminster.
|-
| '''HAT''' or '''HAST'''
| '''HADT'''
| Hawaii-Aleutian Standard/Daylight Time
| {{#ifexpr:{{Daylight saving in time zone|HAT}}||style="background-color:#89CFF0"{{!}}}} UTC'''−10''':00
| {{#ifexpr:{{Daylight saving in time zone|HAT}}|style="background-color:#89CFF0"{{!}}}} UTC'''−09''':00
|-
| '''AKT''' or '''AKST'''
| '''AKDT'''
| Alaska Standard/Daylight Time
| {{#ifexpr:{{Daylight saving in time zone|AKT}}||style="background-color:#89CFF0"{{!}}}} UTC'''−09''':00
| {{#ifexpr:{{Daylight saving in time zone|AKT}}|style="background-color:#89CFF0"{{!}}}} UTC'''−08''':00
|-
| '''PT''' or '''PST'''
| '''PDT'''
| Pacific Standard/Daylight Time
| {{#ifexpr:{{Daylight saving in time zone|PT}}||style="background-color:#89CFF0"{{!}}}} UTC'''−08''':00
| {{#ifexpr:{{Daylight saving in time zone|PT}}|style="background-color:#89CFF0"{{!}}}} UTC'''−07''':00
|-
| '''MT''' or '''MST'''
| '''MDT'''
| Mountain Standard/Daylight Time
| {{#ifexpr:{{Daylight saving in time zone|MT}}||style="background-color:#89CFF0"{{!}}}} UTC'''−07''':00
| {{#ifexpr:{{Daylight saving in time zone|MT}}|style="background-color:#89CFF0"{{!}}}} UTC'''−06''':00
|-
| '''CT''' or '''CST'''
| '''CDT'''
| Central Standard/Daylight Time
| {{#ifexpr:{{Daylight saving in time zone|CT}}||style="background-color:#89CFF0"{{!}}}} UTC'''−06''':00
| {{#ifexpr:{{Daylight saving in time zone|CT}}|style="background-color:#89CFF0"{{!}}}} UTC'''−05''':00
|-
| '''ET''' or '''EST'''
| '''EDT'''
| Eastern Standard/Daylight Time
| {{#ifexpr:{{Daylight saving in time zone|ET}}||style="background-color:#89CFF0"{{!}}}} UTC'''−05''':00
| {{#ifexpr:{{Daylight saving in time zone|ET}}|style="background-color:#89CFF0"{{!}}}} UTC'''−04''':00
|-
| '''AT''' or '''AST'''
| '''ADT'''
| Atlantic Standard/Daylight Time
| {{#ifexpr:{{Daylight saving in time zone|AT}}||style="background-color:#89CFF0"{{!}}}} UTC'''−04''':00
| {{#ifexpr:{{Daylight saving in time zone|AT}}|style="background-color:#89CFF0"{{!}}}} UTC'''−03''':00
|-
| '''NT''' or '''NST'''
| '''NDT'''
| Newfoundland Standard/Daylight Time
| {{#ifexpr:{{Daylight saving in time zone|NT}}||style="background-color:#89CFF0"{{!}}}} UTC'''−03''':30
| {{#ifexpr:{{Daylight saving in time zone|NT}}|style="background-color:#89CFF0"{{!}}}} UTC'''−02''':30
|-
| style="background-color:#F2F2F2" | '''GMT'''
| style="background-color:#F2F2F2" | '''BST'''
| style="background-color:#F2F2F2" | Greenwich Mean Time /<br />British Summer Time
| style="background-color:#{{#ifexpr:{{Daylight saving in time zone|GMT}}|F2F2F2|89CFF0}}" | UTC'''+00''':00
| style="background-color:#{{#ifexpr:{{Daylight saving in time zone|GMT}}|89CFF0|F2F2F2}}" | UTC'''+01''':00
| style="background-color:#F2F2F2" rowspan="4"| 
|-
| style="background-color:#F2F2F2" | '''WET'''
| style="background-color:#F2F2F2" | '''WEST'''
| style="background-color:#F2F2F2" | Western European (Summer) Time
| style="background-color:#{{#ifexpr:{{Daylight saving in time zone|WET}}|F2F2F2|89CFF0}}" | UTC'''+00''':00
| style="background-color:#{{#ifexpr:{{Daylight saving in time zone|WET}}|89CFF0|F2F2F2}}" | UTC'''+01''':00
|-
| style="background-color:#F2F2F2" | '''CET'''
| style="background-color:#F2F2F2" | '''CEST'''
| style="background-color:#F2F2F2" | Central European (Summer) Time
| style="background-color:#{{#ifexpr:{{Daylight saving in time zone|CET}}|F2F2F2|89CFF0}}" | UTC'''+01''':00
| style="background-color:#{{#ifexpr:{{Daylight saving in time zone|CET}}|89CFF0|F2F2F2}}" | UTC'''+02''':00
|-
| style="background-color:#F2F2F2" | '''EET'''
| style="background-color:#F2F2F2" | '''EEST'''
| style="background-color:#F2F2F2" | Eastern European (Summer) Time
| style="background-color:#{{#ifexpr:{{Daylight saving in time zone|EET}}|F2F2F2|89CFF0}}" | UTC'''+02''':00
| style="background-color:#{{#ifexpr:{{Daylight saving in time zone|EET}}|89CFF0|F2F2F2}}" | UTC'''+03''':00
|-
| colspan="2" | '''AWT''' or '''AWST'''
| Australian Western Standard Time
| colspan="2" | UTC'''+08''':00
| rowspan="3" | 

DST is not observed in the AWT time zone.
|-
| '''ACT''' or '''ACST'''
| '''ACDT'''
| Australian Central Standard/Daylight Time
| {{#ifexpr:{{Daylight saving in time zone|ACT}}||style="background-color:#89CFF0"{{!}}}} UTC'''+09''':30
| {{#ifexpr:{{Daylight saving in time zone|ACT}}|style="background-color:#89CFF0"{{!}}}} UTC'''+10''':30
|-
| '''AET''' or '''AEST'''
| '''AEDT'''
| Australian Eastern Standard/Daylight Time
| {{#ifexpr:{{Daylight saving in time zone|AET}}||style="background-color:#89CFF0"{{!}}}} UTC'''+10''':00
| {{#ifexpr:{{Daylight saving in time zone|AET}}|style="background-color:#89CFF0"{{!}}}} UTC'''+11''':00
|-
| colspan="2" style="background-color:#F2F2F2" | '''KST'''
| style="background-color:#F2F2F2" | Korea Standard Time
| colspan="2" style="background-color:#F2F2F2" | UTC'''+09''':00
| style="background-color:#F2F2F2" rowspan="2" | 
|-
| colspan="2" style="background-color:#F2F2F2" | '''JST'''
| style="background-color:#F2F2F2" | Japan Standard Time
| colspan="2" style="background-color:#F2F2F2" | UTC'''+09''':00
|-
| '''NZT''' or '''NZST'''
| '''NZDT'''
| New Zealand Standard/Daylight Time
| {{#ifexpr:{{Daylight saving in time zone|NZT}}||style="background-color:#89CFF0"{{!}}}} UTC'''+12''':00
| {{#ifexpr:{{Daylight saving in time zone|NZT}}|style="background-color:#89CFF0"{{!}}}} UTC'''+13''':00
| 
|}
{{#if:{{{1|}}}||
==Time zone map==
[[File:World Time Zones Map.png|center|800px]]

==Related templates==
*{{tl|Hebrew calendar today in time zone}}
*{{tl|Hebrew calendar tomorrow in time zone}}
*{{tl|Current hour offset in time zone}}
*{{tl|Current minute offset in time zone}}
*{{tl|Current hour in time zone}}
*{{tl|Current minute in time zone}}
*{{tl|Daylight saving in time zone}}
*{{tl|Sefirat HaOmer Box}}
}}

==Source==
Template was substantially copied from its Hebrew Wikipedia [[:he:תבנית:ספירת העומר/אפשרויות|counterpart]].

<includeonly>
[[Category:Date-computing templates based on current time]]
[[Category:Jews and Judaism templates]]
</includeonly>