関数double_in_sec2DegMinSec マニュアル

(The documentation of function double_in_sec2DegMinSec)

Last Update: 2021/12/17


◆機能・用途(Purpose)

秒単位の実数で与えられた緯度または経度を度分秒表記に変換する。
Convert a latitude or longitude, given by a real number in second unit, to a degree-minute-second representation.


◆形式(Format)

#include <coordinate.h>
inline struct DegMinSec double_in_sec2DegMinSec(const double sec)


◆引数(Arguments)

sec 秒単位の実数で表記した緯度または経度。 例えば北緯35度25分15.5秒であれば \(3600\times 35+60\times 25+15.5=127515.5\)を与える。
The latitude or longitude, given by a real number in second unit. For example, in case of a north latitude of 35°25’15.5”, give \(3600\times 35+60\times 25+15.5=127515.5\).


◆戻り値(Return value)

引数secが表す座標の度分秒表記。
The degree-minute-second representation of the coordinate represented by argument sec.


◆使用例(Example)

struct DegMinSec N=double_in_sec2DegMinSec(127515.5);


◆補足(Additional notes)

座標を秒単位の実数で表現することはあまり行われていないが、 度分秒表記の座標を用いて処理を行う際には便利である。 例えば座標を1秒ずつずらしながら何らかのループ処理を行う場合、 度分秒表記のままでは条件分岐がややこしくなり、 小数単位の度表記では丸め誤差が発生する。 このような場合に秒単位の実数表記を用いることで計算が簡単かつ正確になる。
Although it is rare to express a coordinate by a real number in second unit, this expression is convenient in processings based on coordinates expressed by degree-minute-second representation. For example, a loop for every 1 sec would be complecated if a degree-minute-second representation is used directly, while a representation by real number in degrees would cause rounding errors. In this case, use of the real number in second unit realizes easy and accurate implementation of the computation.