Template:Decdeg

From blackwiki
Revision as of 16:28, 20 June 2011 by imported>Jimp (simplify code)
Jump to navigation Jump to search
Template documentation[view] [edit] [history] [purge]


This helper template provides a way to convert 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.

Parameter Description
{{decdeg
| deg = 
| min =
| sec = 
| hem = 
| rnd =
}}
 
Degrees
Minutes
Seconds
Hemisphere
Round
 

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 rnd, which defaults to 7.

Currently this template does not attempt to trap invalid values.

Examples

{{decdeg|deg=37|min=51|sec=00|hem=N}} → 37.85
{{decdeg|deg=119|min=34|sec=04|hem=W}} → -119.5677778

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

{{decdeg|37|51||N}}Expression error: Unexpected / operator.
{{decdeg|119|34||W}}Expression error: Unexpected / operator.

Input can be signed or unsigned decimal degrees:

{{decdeg|37.85|||N}}Expression error: Unexpected / operator.
{{decdeg|119.5666667|||W}}Expression error: Unexpected / operator.
{{decdeg|37.85}} → 37.85
{{decdeg|-119.5666667}} → -119.5666667

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

{{decdeg|37.85||||1}}Expression error: Unexpected / operator.
{{decdeg|-119.5666667||||1}}Expression error: Unexpected / operator.

If a value is undefined then zero is assumed:

{{decdeg||51||N}}Expression error: Unexpected / operator.
{{decdeg||34||W}}Expression error: Unexpected / operator.

Negative zero values are accommodated:

{{decdeg|0|51}}Expression error: Unexpected / operator.
{{decdeg|-0|34}} → -0.5666667

See also