View source for Template:Decdeg/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
__NOTOC__
{{esoteric}}

This [[Help:Templates/Helper templates|helper template]] provides a way to convert [[Geographic coordinate system|geographic coordinates]] from degree, minute, second format to [[decimal degrees]]. It is intended for use in building infobox templates.

=== Usage ===
The template can be used with named or unnamed parameters as shown.

{| class="wikitable"
|- width="50%" valign="top" style="vertical-align:top;"
! Parameter !! Description
|- width="50%" valign="top" style="vertical-align:top;"
| style="vertical-align:top;padding:1ex;" |<pre style="margin:0; border-color:transparent">
{{decdeg
| deg = 
| min =
| sec = 
| hem = 
| rnd =
}}</pre>
| style="vertical-align:top;padding:1ex;" |<pre style="margin:0; border-color:transparent">
&nbsp;
Degrees
Minutes
Seconds
Hemisphere
Round
&nbsp;</pre>
|}

Input degrees can be signed in which case the hemisphere is not required. A negative value implies a value in the western or southern hemisphere. Minutes and seconds need not be specified. If no degrees are specified then a value of zero is assumed. This template does not attempt to trap invalid values and results in this case might be undefined.

The decimal precision of the result is determined by the value assigned <tt>rnd</tt>, which defaults to 7.

Currently this template does not attempt to trap invalid values.

=== Examples ===

:<tt><nowiki>{{decdeg|deg=37|min=51|sec=00|hem=N}}</nowiki></tt> → {{decdeg|deg=37|min=51|sec=00|hem=N}}
:<tt><nowiki>{{decdeg|deg=119|min=34|sec=04|hem=W}}</nowiki></tt> → {{decdeg|deg=119|min=34|sec=04|hem=W}}

When using unnamed parameters, the hemisphere must be the fourth parameter:

:<tt><nowiki>{{decdeg|37|51||N}}</nowiki></tt> → {{decdeg|37|51||N}}
:<tt><nowiki>{{decdeg|119|34||W}}</nowiki></tt> → {{decdeg|119|34||W}}

Input can be signed or unsigned decimal degrees:

:<tt><nowiki>{{decdeg|37.85|||N}}</nowiki></tt> → {{decdeg|37.85|||N}}
:<tt><nowiki>{{decdeg|119.5666667|||W}}</nowiki></tt> → {{decdeg|119.5666667|||W}}

:<tt><nowiki>{{decdeg|37.85}}</nowiki></tt> → {{decdeg|37.85}}
:<tt><nowiki>{{decdeg|-119.5666667}}</nowiki></tt> → {{decdeg|-119.5666667}}

When using rounding, the factor must be the fifth parameter:

:<tt><nowiki>{{decdeg|37.85||||1}}</nowiki></tt> → {{decdeg|37.85||||1}}
:<tt><nowiki>{{decdeg|-119.5666667||||1}}</nowiki></tt> → {{decdeg|-119.5666667||||1}}

If a value is undefined then zero is assumed:

:<tt><nowiki>{{decdeg||51||N}}</nowiki></tt> → {{decdeg||51||N}}
:<tt><nowiki>{{decdeg||34||W}}</nowiki></tt> → {{decdeg||34||W}}

Negative zero values are accommodated:

:<tt><nowiki>{{decdeg|0|51}}</nowiki></tt> → {{decdeg||51||N}}
:<tt><nowiki>{{decdeg|-0|34}}</nowiki></tt> → {{decdeg|-0|34}}

=== See also ===
* [[Template:Coord]]


<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
{{DEFAULTSORT:{{PAGENAME}}}}
[[Category:Conversion templates]]

[[as:Template:Decdeg]]
[[ja:Template:Decdeg]]
[[ur:سانچہ:Decdeg]]
</includeonly>