Class dc_date_generic
In: dc_utils/dc_date_generic.f90

dc_date より提供される手続の引用仕様宣言

Interface of procedures provided from dc_date

モジュールの概要については, dc_date を参照ください.

See "dc_date" for brief of this module.

Procedures List

以下の手続きは構造型 dc_date_types#DC_DATETIME または dc_date_types#DC_DIFFTIME 変数 (日時, 時刻に関する情報を格納) を対象とします.

DCDateTimeCreate :dc_date_types#DC_DATETIME 型変数の初期設定
DCDiffTimeCreate :dc_date_types#DC_DIFFTIME 型変数の初期設定
assignment(=) :dc_date_types#DC_DATETIME 型変数および dc_date_types#DC_DIFFTIME 型変数の初期設定
Eval :日時, 時刻情報を個別に取得
toChar :日時, 時刻情報を文字型変数へ変換
EvalDay :日数 (実数型) に換算して取得
EvalHour :時間 (実数型) に換算して取得
EvalMin :分 (実数型) に換算して取得
EvalSec :秒 (実数型) に換算して取得
EvalNondim :無次元時間 (実数型) に換算して取得
EvalByUnit :単位を指定し, 日, 時, 分, 秒のいづれか (実数型) に換算して取得
operator(+) :加算 (dc_date_types#DC_DATETIME 型 および dc_date_types#DC_DIFFTIME 型 同士)
operator(-) :減算 (dc_date_types#DC_DATETIME 型 および dc_date_types#DC_DIFFTIME 型 同士)
operator(*) :乗算 (dc_date_types#DC_DIFFTIME 型と数値型)
operator(/) :除算 (dc_date_types#DC_DIFFTIME 型と数値型)
mod :余り (dc_date_types#DC_DIFFTIME 型同士)
operator(==) :比較 (dc_date_types#DC_DATETIME 型同士)
operator(>) :比較 (dc_date_types#DC_DATETIME 型同士)
operator(>=) :比較 (dc_date_types#DC_DATETIME 型同士)
operator(<) :比較 (dc_date_types#DC_DATETIME 型同士)
operator(<=) :比較 (dc_date_types#DC_DATETIME 型同士)
max :大きい値を返す
min :小さい値を返す
SetZone :タイムゾーンを変更
DCDateTimePutLine :dc_date_types#DC_DATETIME 型変数に格納されている 日時, 時刻情報の印字
DCDiffTimePutLine :dc_date_types#DC_DIFFTIME 型変数に格納されている 日時, 時刻情報の印字

以下の手続きは dc_date_types 内部の変数を変更します.

SetCaltype :暦法のデフォルトを変更
SetSecOfDay :1 日の秒数のデフォルトを変更

その他の手続き

ValidCaltype :暦法が有効なものかをチェック
ValidZone :タイムゾーンとして有効化をチェック
ZoneToDiff :タイムゾーンを dc_date_types#DC_DIFFTIME 変数へと変換
ParseTimeUnits :時間の単位を解析し, 単位のシンボルを返します.

Usage

現在時刻の表示

dc_date_types#DC_DATETIME 型の変数にサブルーチン DCDateTimeCreate を用いると, 時刻が設定されます. 下記のように特に年月日を指定しないと現在時刻が設定されます. 設定された時刻は toChar によって文字型変数へと変換できます. サブルーチン Printf に関しては dc_string#Printf を参照ください.

    program dc_date_sapmle1
      use dc_string, only: Printf
      use dc_date, only: DC_DATETIME, DCDateTimeCreate, toChar
      implicit none
      type(DC_DATETIME) :: time

      call DCDateTimeCreate( time = time ) ! (out)
      call Printf( fmt = 'current date and time is %c', c1 = trim( toChar(time) ) )
    end program dc_date_sapmle1

日時, 時刻情報の加算

dc_date_types#DC_DIFFTIME 型の変数は日時差を表現します. 下記の例では, 日時差を表現するための変数として diff を用意し, サブルーチン Create によって 25 日 + 12 時間 + 50 分の日時差 を設定しています. dc_date_types#DC_DATETIME 型の変数 time_beforediff とを operator(+) によって加算することで time_before から 25 日 + 12 時間 + 50 分を進めた日時 time_after を取得しています.

    program dc_date_sapmle2
      use dc_types, only: DP
      use dc_string, only: Printf
      use dc_date, only: DC_DATETIME, DC_DIFFTIME, &
        & DCDateTimeCreate, DCDiffTimeCreate, toChar, operator(+)
      implicit none
      type(DC_DATETIME) :: time_before, time_after
      type(DC_DIFFTIME) :: diff

      call DCDateTimeCreate( time = time_before, & ! (out)
        & year = 2006, mon = 6,  day = 10, &       ! (in)
        & hour = 14,   min = 15, sec = 0.0_DP )    ! (in)
      call DCDiffTimeCreate( diff = diff, &        ! (out)
        & day = 25, hour = 12, min = 50)           ! (in)

      time_after = time_before + diff

      call Printf( fmt = '%c + %c = %c', &
        & c1 = trim( toChar(time_before) ), c2 = trim( toChar(diff) ), &
        & c3 = trim( toChar(time_after) ) )
    end program dc_date_sapmle2

時間積分のループへの応用

以下は dA/dt = - αA (初期値 1, α=0.0001) を t = 12 (時間) まで解くプログラムの例です. 時間積分には前進差分を用いています. Δt, データの出力間隔, 計算時間に dc_date_types#DC_DIFFTIME を用いることで, ループの終了処理や データ出力の際の時刻の比較が容易となります.

    program dc_date_sapmle3
      use dc_types, only: DP
      use dc_date, only: DC_DIFFTIME, &
        & DCDiffTimeCreate, EvalSec, EvalByUnit, mod, &
        & operator(*), operator(==), operator(>)
      implicit none
      real(DP)                :: func_a = 1.0d0    ! 関数 A の初期値
      real(DP), parameter     :: alph   = 0.0001d0 ! 係数 α
      character(*), parameter :: out_unit = 'hour' ! 出力される時刻の単位
      type(DC_DIFFTIME):: DelTimef, intervalf, calctimef
      integer :: i
    continue
      call DCDiffTimeCreate( &            !       Δt = 5.0 (秒)
        & diff = DelTimef, &              ! (out)
        & value = 5.0_DP, unit = 'sec')   ! (in)
      call DCDiffTimeCreate( &            !       データ出力間隔 = 1.0 (分)
        & diff = intervalf, &             ! (out)
        & value = 1.0_DP, unit = 'min')   ! (in)
      call DCDiffTimeCreate( &            !       計算時間 = 12.0 (時間)
        & diff = calctimef, &             ! (out)
        & value = 12.0_DP, unit = 'hour') ! (in)

      open( 10, file='dc_date_sample.dat' )
      write(10,'(A,A,A)') '#  ', out_unit, '                value'

      i = 1
      do
        if (DelTimef * i > calctimef) exit    ! 計算時間を過ぎたら終了

        !---------------------------------------------
        ! A_(n+1) = (1 - αΔt) * A_(n)
        !---------------------------------------------
        func_a = (1.0 - alph * EvalSec(DelTimef)) * func_a

        !---------------------------------------------
        ! intervalf (1 分) 毎にデータを出力
        !---------------------------------------------
        if (mod(DelTimef * i, intervalf) == 0) then
          write(10,*) ' ', EvalByUnit( DelTimef * i, out_unit ), func_a
        end if
        i = i + 1
      end do
    end program dc_date_sapmle3

Methods

Included Modules

dc_date_types dc_types dc_present dc_scaledsec

Public Instance methods

Create( time, [year], [mon], [day], [hour], [min], [sec], [zone], [caltype], [day_seconds], [err] )
Subroutine :
time :type(DC_DATETIME), intent(out)
year :integer, intent(in), optional
mon :integer, intent(in), optional
day :integer, intent(in), optional
hour :integer, intent(in), optional
min :integer, intent(in), optional
sec :real(DP),intent(in), optional
zone :character(*), intent(in), optional
caltype :integer, intent(in), optional
day_seconds :real(DP),intent(in), optional
err :logical, intent(out), optional

Original external subprogram is dc_utils/dcdatetimecreate.f90#DCDateTimeCreate1_bc

Create( diff, [year], [mon], [day], [hour], [min], [sec], [day_seconds] )
Subroutine :
diff :type(DC_DIFFTIME), intent(out)
year :integer, intent(in), optional
mon :integer, intent(in), optional
day :integer, intent(in), optional
hour :integer, intent(in), optional
min :integer, intent(in), optional
sec :real(DP),intent(in), optional
day_seconds :real(DP),intent(in), optional

Original external subprogram is dc_utils/dcdatetimecreate.f90#DCDiffTimeCreate1_bc

Create( diff, value, unit, [err] )
Subroutine :
diff :type(DC_DIFFTIME), intent(out)
value :real(DP), intent(in)
unit :character(*), intent(in)
err :logical, intent(out), optional

Original external subprogram is dc_utils/dcdatetimecreate.f90#DCDiffTimeCreate2_bc

DCDateTimeCreate( time, [year], [mon], [day], [hour], [min], [sec], [zone], [zone_hour], [zone_min], [caltype], [caltype_str], [day_seconds], [sclyear], [sclmon], [sclday], [sclsec], [err] )
Subroutine :
time :type(DC_DATETIME), intent(out)
year :integer, intent(in), optional
:
mon :integer, intent(in), optional
:
day :integer, intent(in), optional
:
hour :integer, intent(in), optional
:
min :integer, intent(in), optional
:
sec :real(DP),intent(in), optional
:
zone :character(*), intent(in), optional
: UTC からの時差
zone_hour :integer, intent(in), optional
: UTC からの時差 (時)
zone_min :integer, intent(in), optional
: UTC からの時差 (分)
caltype :integer, intent(in), optional
: 暦法
caltype_str :character(*), intent(in), optional
: 暦法 (文字型による指定)
day_seconds :real(DP),intent(in), optional
: 1 日の秒数
sclyear :type(DC_SCALED_SEC), intent(in), optional
: 年 (DC_SCALED_SEC 型)
sclmon :type(DC_SCALED_SEC), intent(in), optional
: 月 (DC_SCALED_SEC 型)
sclday :type(DC_SCALED_SEC), intent(in), optional
: 日 (DC_SCALED_SEC 型)
sclsec :type(DC_SCALED_SEC), intent(in), optional
: 秒 (DC_SCALED_SEC 型)
err :logical, intent(out), optional

dc_date_types#DC_DATETIME 型変数の生成を行います. 引数 year, mon, day, hour, min, sec の全てを与えない場合, このサブルーチンが呼ばれた際の時刻が使用されます.

引数 caltype には暦法を設定します. dc_date_types#CAL_CYCLIC, dc_date_types#CAL_NOLEAP, dc_date_types#CAL_JULIAN, dc_date_types#CAL_GREGORIAN のいづれかを与えてください. 引数 caltype を指定しない場合, 暦法は dc_date_types#CAL_GREGORIAN に設定されます. 暦法は caltype_str に文字列を与えることでも指定可能です. 上記の暦法に対応する文字列は以下の通りです. (大文字小文字は区別しません)

dc_date_types#CAL_CYCLIC :cyclic
dc_date_types#CAL_NOLEAP :noleap
dc_date_types#CAL_JULIAN :julian
dc_date_types#CAL_GREGORIAN :gregorian

引数 zone には UTC からの時差を設定します. ’+09:00’ や ’-13:00’ のように時差を 6 文字で指定してください. 引数 zone を指定しない場合, date_and_time 組み込みサブルーチン によって得られる時差を設定します. 時差は zone_hour または zone_min に整数型を与えることでも 指定可能です.

引数 day_seconds には 1 日何秒かを設定します. この引数を 指定しない場合, dc_date_types#day_seconds の値が用いられます. dc_date_types#day_secondsSetSecOfDay で変更可能です.

引数 caltype および, zone に不適切な値が与えられた場合, エラーを発生させます. 引数 err を与えている場合には err に .true. が返り, プログラムは続行します.

Original external subprogram is dc_utils/dcdatetimecreate.f90#DCDateTimeCreate1

DCDateTimePutLine( time, [unit], [indent] )
Subroutine :
time :type(DC_DATETIME), intent(in)
unit :integer, intent(in), optional
: 出力先の装置番号. デフォルトの出力先は標準出力.

Unit number for output. Default value is standard output.

indent :character(*), intent(in), optional
: 表示されるメッセージの字下げ.

Indent of displayed messages.

引数 time に設定されている情報を印字します. デフォルトではメッセージは標準出力に出力されます. unit に装置番号を指定することで, 出力先を変更することが可能です.

Print information of time. By default messages are output to standard output. Unit number for output can be changed by unit argument.

Original external subprogram is dc_utils/dcdatetimeputline.f90#DCDateTimePutLine

DCDiffTimeCreate( diff, [year], [mon], [day], [hour], [min], [sec], [day_seconds], [nondim], [sclyear], [sclmon], [sclday], [sclsec] )
Subroutine :
diff :type(DC_DIFFTIME), intent(out)
year :integer, intent(in), optional
: 年. Year
mon :integer, intent(in), optional
: 月. Month
day :integer, intent(in), optional
: 日. Day
hour :integer, intent(in), optional
: 時. Hour
min :integer, intent(in), optional
: 分. Minute
sec :real(DP), intent(in), optional
: 秒. Second
day_seconds :real(DP), intent(in), optional
: 1 日の秒数
nondim :real(DP), intent(in), optional
: 無次元時間. Nondimensional time
sclyear :type(DC_SCALED_SEC), intent(in), optional
: 年 (DC_SCALED_SEC 型)
sclmon :type(DC_SCALED_SEC), intent(in), optional
: 月 (DC_SCALED_SEC 型)
sclday :type(DC_SCALED_SEC), intent(in), optional
: 日 (DC_SCALED_SEC 型)
sclsec :type(DC_SCALED_SEC), intent(in), optional
: 秒 (DC_SCALED_SEC 型)

dc_date_types#DC_DIFFTIME 型変数の生成を行います. 引数 year, mon, day, hour, min, sec, nondim を与えない場合, 0 が与えられたことになります.

引数 day_seconds には 1 日何秒かを設定します. この引数を 指定しない場合, dc_date_types#day_seconds の値が用いられます. dc_date_types#day_secondsSetSecOfDay で変更可能です.

Original external subprogram is dc_utils/dcdatetimecreate.f90#DCDiffTimeCreate1

DCDiffTimeCreate( diff, value, unit, [unit_symbol], [err] )
Subroutine :
diff :type(DC_DIFFTIME), intent(out)
value :real(DP), intent(in)
unit :character(*), intent(in)
unit_symbol :integer, intent(in), optional
err :logical, intent(out), optional

dc_date_types#DC_DIFFTIME 型変数の生成を行います. 引数 value に数値を, unit に単位を表す文字列を, または unit_symbol に単位を表すシンボルを与えてください.

unit に指定できるのは以下の文字列です. (大文字小文字は区別しません).

年 :dc_date_types#UNIT_YEAR
月 :dc_date_types#UNIT_MONTH
日 :dc_date_types#UNIT_DAY
時 :dc_date_types#UNIT_HOUR
分 :dc_date_types#UNIT_MIN
秒 :dc_date_types#UNIT_SEC
無次元時間 :dc_date_types#UNIT_NONDIM

これらに該当しない文字列を unit に与えた場合, エラーを発生させます.

unit_symbol に指定できるのは以下のシンボルです.

年 :dc_date_types#UNIT_SYMBOL_YEAR
月 :dc_date_types#UNIT_SYMBOL_MONTH
日 :dc_date_types#UNIT_SYMBOL_DAY
時 :dc_date_types#UNIT_SYMBOL_HOUR
分 :dc_date_types#UNIT_SYMBOL_MIN
秒 :dc_date_types#UNIT_SYMBOL_SEC
無次元時間 :dc_date_types#UNIT_SYMBOL_NONDIM

これらに該当しないシンボルを unit_symbol に与えた場合, エラーを発生させます.

引数 err を与えている場合には err に .true. が返り, プログラムは続行します.

Original external subprogram is dc_utils/dcdatetimecreate.f90#DCDiffTimeCreate2D

DCDiffTimeCreate( diff, value, unit, [unit_symbol], [err] )
Subroutine :
diff :type(DC_DIFFTIME), intent(out)
value :real, intent(in)
unit :character(*), intent(in)
unit_symbol :integer, intent(in), optional
err :logical, intent(out), optional

Original external subprogram is dc_utils/dcdatetimecreate.f90#DCDiffTimeCreate2R

DCDiffTimeCreate( diff, value, unit, [unit_symbol], [err] )
Subroutine :
diff :type(DC_DIFFTIME), intent(out)
value :integer, intent(in)
unit :character(*), intent(in)
unit_symbol :integer, intent(in), optional
err :logical, intent(out), optional

Original external subprogram is dc_utils/dcdatetimecreate.f90#DCDiffTimeCreate2I

DCDiffTimePutLine( diff, [unit], [indent] )
Subroutine :
diff :type(DC_DIFFTIME), intent(in)
unit :integer, intent(in), optional
: 出力先の装置番号. デフォルトの出力先は標準出力.

Unit number for output. Default value is standard output.

indent :character(*), intent(in), optional
: 表示されるメッセージの字下げ.

Indent of displayed messages.

引数 diff に設定されている情報を印字します. デフォルトではメッセージは標準出力に出力されます. unit に装置番号を指定することで, 出力先を変更することが可能です.

Print information of diff. By default messages are output to standard output. Unit number for output can be changed by unit argument.

Original external subprogram is dc_utils/dcdatetimeputline.f90#DCDiffTimePutLine

Eval( time, [year], [mon], [day], [hour], [min], [sec], [caltype], [zone], [sclyear], [sclmon], [sclday], [sclsec] )
Subroutine :
time :type(DC_DATETIME), intent(in)
year :integer, intent(out), optional
:
mon :integer, intent(out), optional
:
day :integer, intent(out), optional
:
hour :integer, intent(out), optional
:
min :integer, intent(out), optional
:
sec :real(DP),intent(out), optional
:
caltype :integer, intent(out), optional
: 暦法
zone :character(*), intent(out), optional
: タイムゾーン (UTC からの時差)
sclyear :type(DC_SCALED_SEC), intent(out), optional
: 年 (DC_SCALED_SEC 型)
sclmon :type(DC_SCALED_SEC), intent(out), optional
: 月 (DC_SCALED_SEC 型)
sclday :type(DC_SCALED_SEC), intent(out), optional
: 日 (DC_SCALED_SEC 型)
sclsec :type(DC_SCALED_SEC), intent(out), optional
: 秒 (DC_SCALED_SEC 型)

dc_date_types#DC_DATETIME 型変数 time を 年 year, 月 mon, 日 day, 時間 hour, 分 min, 秒 sec, 暦法 caltype, タイムゾーン zone に変換して返します.

Original external subprogram is dc_utils/dcdatetimeeval.f90#DCDateTimeEval1

Eval( diff, [year], [mon], [day], [hour], [min], [sec], [nondim], [sclyear], [sclmon], [sclday], [sclsec], [sclnondim], [err] )
Subroutine :
diff :type(DC_DIFFTIME), intent(in)
year :integer, intent(out), optional
:
mon :integer, intent(out), optional
:
day :integer, intent(out), optional
:
hour :integer, intent(out), optional
:
min :integer, intent(out), optional
:
sec :real(DP),intent(out), optional
:
nondim :real(DP),intent(out), optional
: 無次元時間. Nondimensional time
sclyear :type(DC_SCALED_SEC), intent(out), optional
: 年 (DC_SCALED_SEC 型)
sclmon :type(DC_SCALED_SEC), intent(out), optional
: 月 (DC_SCALED_SEC 型)
sclday :type(DC_SCALED_SEC), intent(out), optional
: 日 (DC_SCALED_SEC 型)
sclsec :type(DC_SCALED_SEC), intent(out), optional
: 秒 (DC_SCALED_SEC 型)
sclnondim :type(DC_SCALED_SEC), intent(out), optional
: 無次元時間 (DC_SCALED_SEC 型)
err :logical, intent(out), optional

dc_date_types#DC_DIFFTIME 型変数 diff を 年 year, 月 mon, 日 day, 時間 hour, 分 min, 秒 sec, 無次元時間 nondim に変換して返します.

Original external subprogram is dc_utils/dcdatetimeeval.f90#DCDiffTimeEval1

EvalByUnit( diff, unit, [unit_symbol] ) result(result)
Function :
result :real(DP)
diff :type(DC_DIFFTIME), intent(in)
unit :character(*), intent(in)
unit_symbol :integer, intent(in), optional

dc_date_types#DC_DIFFTIME 型変数の日時を unit の単位 に換算して倍精度実数型変数で返します.

unit には 日 dc_date_types#UNIT_DAY, 時 dc_date_types#UNIT_HOUR, 分 dc_date_types#UNIT_MIN, 秒 dc_date_types#UNIT_SEC, 無次元時間 dc_date_types#UNIT_NONDIM を与えることが可能です.

unit_symbol には 日 dc_date_types#UNIT_SYMBOL_DAY, 時 dc_date_types#UNIT_SYMBOL_HOUR, 分 dc_date_types#UNIT_SYMBOL_MIN, 秒 dc_date_types#UNIT_SYMBOL_SEC 無次元時間 dc_date_types#UNIT_SYMBOL_NONDIM を与えることが可能です.

これらに該当しないものを unit または unit_symbol に与えた場合, もしくは引数を両方とも与えない場合, 0.0 が返ります.

Original external subprogram is dc_utils/dcdatetimeeval.f90#DCDiffTimeEvalByUnit

EvalByUnit( time, unit, [unit_symbol] ) result(result)
Function :
result :real(DP)
time :type(DC_DATETIME), intent(in)
unit :character(*), intent(in)
unit_symbol :integer, intent(in), optional

dc_date_types#DC_DATETIME 型変数の日時を unit または unit_symbol の単位 に換算して倍精度実数型変数で返します.

unit には 日 dc_date_types#UNIT_DAY, 時 dc_date_types#UNIT_HOUR, 分 dc_date_types#UNIT_MIN, 秒 dc_date_types#UNIT_SEC を与えることが可能です.

unit_symbol には 日 dc_date_types#UNIT_SYMBOL_DAY, 時 dc_date_types#UNIT_SYMBOL_HOUR, 分 dc_date_types#UNIT_SYMBOL_MIN, 秒 dc_date_types#UNIT_SYMBOL_SEC を与えることが可能です.

これらに該当しないものを unit または unit_symbol に与えた場合, もしくは引数を両方とも与えない場合, 0.0 が返ります.

Original external subprogram is dc_utils/dcdatetimeeval.f90#DCDateTimeEvalByUnit

EvalDay( time ) result(result)
Function :
result :real(DP)
time :type(DC_DATETIME), intent(in)

dc_date_types#DC_DATETIME 型変数の日時を日数に換算して 倍精度実数型変数で返します. (例えば 12 時間は 0.5 日と換算されます).

Original external subprogram is dc_utils/dcdatetimeeval.f90#DCDateTimeEvalDay

EvalDay( diff ) result(result)
Function :
result :real(DP)
diff :type(DC_DIFFTIME), intent(in)

dc_date_types#DC_DIFFTIME 型変数の日時を日数に換算して 倍精度実数型変数で返します. (例えば 12 時間は 0.5 日と換算されます).

1 ヶ月は dc_date_types#CYCLIC_MDAYS と換算します.

Original external subprogram is dc_utils/dcdatetimeeval.f90#DCDiffTimeEvalDay

EvalHour( time ) result(result)
Function :
result :real(DP)
time :type(DC_DATETIME), intent(in)

dc_date_types#DC_DATETIME 型変数の日時を時間に換算して 倍精度実数型変数で返します. (例えば 2 日は 48 時間に, 30 分 は 0.5 時間と換算されます).

Original external subprogram is dc_utils/dcdatetimeeval.f90#DCDateTimeEvalHour

EvalHour( diff ) result(result)
Function :
result :real(DP)
diff :type(DC_DIFFTIME), intent(in)

dc_date_types#DC_DIFFTIME 型変数の日時を時間に換算して 倍精度実数型変数で返します. (例えば 2 日は 48 時間に, 30 分 は 0.5 時間と換算されます).

1 ヶ月は dc_date_types#CYCLIC_MDAYS と換算します.

Original external subprogram is dc_utils/dcdatetimeeval.f90#DCDifftimeEvalHour

EvalMin( time ) result(result)
Function :
result :real(DP)
time :type(DC_DATETIME), intent(in)

dc_date_types#DC_DATETIME 型変数の日時を分に換算して 倍精度実数型変数で返します. (例えば 1 日は 3600 分に, 30 秒 は 0.5 分と換算されます).

Original external subprogram is dc_utils/dcdatetimeeval.f90#DCDateTimeEvalMin

EvalMin( diff ) result(result)
Function :
result :real(DP)
diff :type(DC_DIFFTIME), intent(in)

dc_date_types#DC_DIFFTIME 型変数の日時を分に換算して 倍精度実数型変数で返します. (例えば 1 日は 3600 分に, 30 秒 は 0.5 分と換算されます).

1 ヶ月は dc_date_types#CYCLIC_MDAYS と換算します.

Original external subprogram is dc_utils/dcdatetimeeval.f90#DCDifftimeEvalMin

EvalNondim( diff ) result(result)
Function :
result :real(DP)
diff :type(DC_DIFFTIME), intent(in)

dc_date_types#DC_DIFFTIME 型変数の日時を無時限時間に換算して 倍精度実数型変数で返します.

1 ヶ月は dc_date_types#CYCLIC_MDAYS と換算します.

Original external subprogram is dc_utils/dcdatetimeeval.f90#DCDiffTimeEvalNondim

EvalSclSec( time ) result(result)
Function :
result :type(DC_SCALED_SEC)
time :type(DC_DATETIME), intent(in)

dc_date_types#DC_DATETIME 型変数の日時を秒に換算して DC_SCALED_SEC 型で返します.

年の要素は無視されます. すなわち, 1999-01-01 が格納された time と 2007-01-01 が格納された time からは同じ値が返ります. (これはもしかすると望ましく無い動作かもしれません).

Original external subprogram is dc_utils/dcdatetimeeval.f90#DCDateTimeEvalSclSec

EvalSclSec( diff ) result(result)
Function :
result :type(DC_SCALED_SEC)
diff :type(DC_DIFFTIME), intent(in)

dc_date_types#DC_DIFFTIME 型変数の日時を秒に換算して DC_SCALED_SEC 型で返します.

1 ヶ月は dc_date_types#CYCLIC_MDAYS と換算します.

Original external subprogram is dc_utils/dcdatetimeeval.f90#DCDifftimeEvalSclSec

EvalSec( time ) result(result)
Function :
result :real(DP)
time :type(DC_DATETIME), intent(in)

dc_date_types#DC_DATETIME 型変数の日時を秒に換算して 倍精度実数型変数で返します.

年の要素は無視されます. すなわち, 1999-01-01 が格納された time と 2007-01-01 が格納された time からは同じ値が返ります. (これはもしかすると望ましく無い動作かもしれません).

Original external subprogram is dc_utils/dcdatetimeeval.f90#DCDateTimeEvalSec

EvalSec( diff ) result(result)
Function :
result :real(DP)
diff :type(DC_DIFFTIME), intent(in)

dc_date_types#DC_DIFFTIME 型変数の日時を秒に換算して 倍精度実数型変数で返します.

1 ヶ月は dc_date_types#CYCLIC_MDAYS と換算します.

Original external subprogram is dc_utils/dcdatetimeeval.f90#DCDifftimeEvalSec

ParseTimeUnits( str ) result(symbol)
Function :
symbol :integer
str :character(*), intent(in)

引数 str に与えられた文字列を解釈し, 日時の単位を示す シンボルを返します. それぞれ以下の文字列が日時の単位として解釈されます. 大文字と小文字は区別されません.

年 :dc_date_types#UNIT_YEAR
月 :dc_date_types#UNIT_MONTH
日 :dc_date_types#UNIT_DAY
時 :dc_date_types#UNIT_HOUR
分 :dc_date_types#UNIT_MIN
秒 :dc_date_types#UNIT_SEC
無次元時間 :dc_date_types#UNIT_NONDIM

返るシンボル (整数型) は以下の通りです.

年 :dc_date_types#UNIT_SYMBOL_YEAR
月 :dc_date_types#UNIT_SYMBOL_MONTH
日 :dc_date_types#UNIT_SYMBOL_DAY
時 :dc_date_types#UNIT_SYMBOL_HOUR
分 :dc_date_types#UNIT_SYMBOL_MIN
秒 :dc_date_types#UNIT_SYMBOL_SEC
無次元時間 :dc_date_types#UNIT_SYMBOL_NONDIM

これらに該当しない文字列を str に与えた場合, dc_date_types#UNIT_SYMBOL_ERR が返ります.

Original external subprogram is dc_utils/dcdatetimeparseunits.f90#DCDateTimeParseUnits

PutLine( diff, [unit] )
Subroutine :
diff :type(DC_DIFFTIME), intent(in)
unit :integer, intent(in), optional

Original external subprogram is dc_utils/dcdatetimeputline.f90#DCDiffTimePutLine_bc

PutLine( time, [unit] )
Subroutine :
time :type(DC_DATETIME), intent(in)
unit :integer, intent(in), optional

Original external subprogram is dc_utils/dcdatetimeputline.f90#DCDateTimePutLine_bc

SetCaltype( caltype )
Subroutine :
caltype :integer, intent(in)

暦法のデフォルトを設定します. dc_date_types#CAL_CYCLIC, dc_date_types#CAL_NOLEAP, dc_date_types#CAL_JULIAN, dc_date_types#CAL_GREGORIAN のいづれかを引数 caltype に与えてください.

なお, この手続きを呼ばない場合, デフォルトの暦法は dc_date_types#CAL_GREGORIAN に設定されています.

Original external subprogram is dc_utils/dcdatetimesetcaltype.f90#DCDateTimeSetCaltype

SetSecOfDay( sec )
Subroutine :
sec :real(DP), intent(in)

1 日の秒数のデフォルトを設定します.

なお, この手続きを呼ばない場合, デフォルトの 1 日の秒数は dc_date_types#DAY_SECONDS_EARTH に設定されています.

Original external subprogram is dc_utils/dcdatetimesetsecofday.f90#DCDateTimeSetSecOfDay

SetZone( time, zone, [err] )
Subroutine :
time :type(DC_DATETIME), intent(inout)
zone :character(*), intent(in)
err :logical, intent(out), optional

引数 time のタイムゾーンを zone へと変更します. 実質的な日時は変更しません.

引数 zone に不適切な値が与えられた場合, エラーを発生させます. 引数 err を与えている場合には err に .true. が返り, プログラムは続行します.

Original external subprogram is dc_utils/dcdatetimezone.f90#DCDateTimeSetZone

ValidCaltype( caltype ) result(result)
Function :
result :logical
caltype :integer, intent(in)

与えられる暦法が dc_date_types 内で有効であれば .true. を, それ以外の場合は .false. を返します.

Original external subprogram is dc_utils/dcdatetimevalidcaltype.f90#DCDateTimeValidCaltype

ValidZone( zone ) result(result)
Function :
result :logical
zone :character(*), intent(in)

与えられるタイムゾーンの表記が有効であれば .true. を, それ以外の場合は .false. を返します.

タイムゾーンの表記は ’+09:00’ のように, 1 文字目が ’+’ または ’-’, 2〜3, 5〜6 文字目が数値で, 4 文字目が ’:’ となります.

Original external subprogram is dc_utils/dcdatetimezone.f90#DCDateTimeValidZone

ZoneToDiff( zone ) result(diff)
Function :
diff :type(DC_DIFFTIME)
zone :character(*), intent(in)

与えられるタイムゾーンを dc_date_types#DC_DIFFTIME 変数へと 変換して返します. タイムゾーンの表記が無効な場合は ’+00:00’ が与えられたと解釈します.

Original external subprogram is dc_utils/dcdatetimezone.f90#DCDateTimeZoneToDiff

assignment(=)( time, sec )
Subroutine :
time :type(DC_DATETIME), intent(out)
sec :integer, intent(in)

dc_date_types#DC_DATETIME 型変数の生成を行います. 引数 sec には秒数を与えてください. 年月日, 時分を使って 指定を行いたい場合は Create を利用してください.

Original external subprogram is dc_utils/dcdatetimecreate.f90#DCDateTimeCreateI

assignment(=)( time, sec )
Subroutine :
time :type(DC_DATETIME), intent(out)
sec :real, intent(in)

dc_date_types#DC_DATETIME 型変数の生成を行います. 引数 sec には秒数を与えてください. 年月日, 時分を使って 指定を行いたい場合は Create を利用してください.

Original external subprogram is dc_utils/dcdatetimecreate.f90#DCDateTimeCreateR

assignment(=)( time, sec )
Subroutine :
time :type(DC_DATETIME), intent(out)
sec :real(DP), intent(in)

Original external subprogram is dc_utils/dcdatetimecreate.f90#DCDateTimeCreateD

assignment(=)( diff, sec )
Subroutine :
diff :type(DC_DIFFTIME), intent(out)
sec :integer, intent(in)

dc_date_types#DC_DIFFTIME 型変数の生成を行います. 引数 sec には秒数を与えてください. 年月日, 時分を使って 指定を行いたい場合は Create を利用してください.

Original external subprogram is dc_utils/dcdatetimecreate.f90#DCDiffTimeCreateI

assignment(=)( diff, sec )
Subroutine :
diff :type(DC_DIFFTIME), intent(out)
sec :real, intent(in)

dc_date_types#DC_DIFFTIME 型変数の生成を行います. 引数 sec には秒数を与えてください. 年月日, 時分を使って 指定を行いたい場合は Create を利用してください.

Original external subprogram is dc_utils/dcdatetimecreate.f90#DCDiffTimeCreateR

assignment(=)( diff, sec )
Subroutine :
diff :type(DC_DIFFTIME), intent(out)
sec :real(DP), intent(in)

Original external subprogram is dc_utils/dcdatetimecreate.f90#DCDiffTimeCreateD

max( time1, time2 ) result(result)
Function :
result :type(DC_DATETIME)
time1 :type(DC_DATETIME), intent(in)
time2 :type(DC_DATETIME), intent(in)

2 つの引数の日時を比較し, より日時が進んでいる方を返します.

Original external subprogram is dc_utils/dcdatetimemax.f90#dcdatetime_max_tt

max( diff1, diff2 ) result(result)
Function :
result :type(DC_DIFFTIME)
diff1 :type(DC_DIFFTIME), intent(in)
diff2 :type(DC_DIFFTIME), intent(in)

2 つの引数の日時差を比較し, より大きい方を返します.

Original external subprogram is dc_utils/dcdatetimemax.f90#dcdatetime_max_ff

min( time1, time2 ) result(result)
Function :
result :type(DC_DATETIME)
time1 :type(DC_DATETIME), intent(in)
time2 :type(DC_DATETIME), intent(in)

2 つの引数の日時を比較し, より日時が遅れている方を返します.

Original external subprogram is dc_utils/dcdatetimemin.f90#dcdatetime_min_tt

min( diff1, diff2 ) result(result)
Function :
result :type(DC_DIFFTIME)
diff1 :type(DC_DIFFTIME), intent(in)
diff2 :type(DC_DIFFTIME), intent(in)

2 つの引数の日時差を比較し, より小さい方を返します.

Original external subprogram is dc_utils/dcdatetimemin.f90#dcdatetime_min_ff

mod( diff1, diff2 ) result(result)
Function :
result :type(DC_DIFFTIME)
diff1 :type(DC_DIFFTIME), intent(in)
diff2 :type(DC_DIFFTIME), intent(in)

引数 diff1diff2 で除算した際の余りを返します.

※ 注意: 月差と日時の混在する除算は近似的結果になるおそれがあります

Original external subprogram is dc_utils/dcdatetimemod.f90#dcdatetime_mod_ff

operator(*)( factor, diff ) result(result)
Function :
result :type(DC_DIFFTIME)
factor :integer, intent(in)
diff :type(DC_DIFFTIME), intent(in)

日時差 difffacter とを乗算した結果を返します.

Original external subprogram is dc_utils/dcdatetimemul.f90#dcdatetime_mul_if

operator(*)( diff, factor ) result(result)
Function :
result :type(DC_DIFFTIME)
diff :type(DC_DIFFTIME), intent(in)
factor :integer, intent(in)

Original external subprogram is dc_utils/dcdatetimemul.f90#dcdatetime_mul_fi

operator(*)( factor, diff ) result(result)
Function :
result :type(DC_DIFFTIME)
factor :real, intent(in)
diff :type(DC_DIFFTIME), intent(in)

※ 注意 : 月差を非整数倍すると近似的結果になるおそれがあります

Original external subprogram is dc_utils/dcdatetimemul.f90#dcdatetime_mul_rf

operator(*)( diff, factor ) result(result)
Function :
result :type(DC_DIFFTIME)
diff :type(DC_DIFFTIME), intent(in)
factor :real, intent(in)

※ 注意 : 月差を非整数倍すると近似的結果になるおそれがあります

Original external subprogram is dc_utils/dcdatetimemul.f90#dcdatetime_mul_fr

operator(*)( factor, diff ) result(result)
Function :
result :type(DC_DIFFTIME)
factor :real(DP), intent(in)
diff :type(DC_DIFFTIME), intent(in)

※ 注意 : 月差を非整数倍すると近似的結果になるおそれがあります

Original external subprogram is dc_utils/dcdatetimemul.f90#dcdatetime_mul_df

operator(*)( diff, factor ) result(result)
Function :
result :type(DC_DIFFTIME)
diff :type(DC_DIFFTIME), intent(in)
factor :real(DP), intent(in)

※ 注意 : 月差を非整数倍すると近似的結果になるおそれがあります

Original external subprogram is dc_utils/dcdatetimemul.f90#dcdatetime_mul_fd

operator(+)( diff, sec ) result(result)
Function :
result :type(DC_DIFFTIME)
diff :type(DC_DIFFTIME), intent(in)
sec :integer, intent(in)

Original external subprogram is dc_utils/dcdatetimeadd.f90#dcdatetime_add_fi

operator(+)( diff, sec ) result(result)
Function :
result :type(DC_DIFFTIME)
diff :type(DC_DIFFTIME), intent(in)
sec :real(DP), intent(in)

Original external subprogram is dc_utils/dcdatetimeadd.f90#dcdatetime_add_fd

operator(+)( diff, sec ) result(result)
Function :
result :type(DC_DIFFTIME)
diff :type(DC_DIFFTIME), intent(in)
sec :real, intent(in)

Original external subprogram is dc_utils/dcdatetimeadd.f90#dcdatetime_add_fr

operator(+)( diff, time ) result(result)
Function :
result :type(DC_DATETIME)
diff :type(DC_DIFFTIME), intent(in)
time :type(DC_DATETIME), intent(in)

2 つの日時 (DC_DATETIME 型) もしくは 日時差 (DC_DIFFTIME 型)の加算を行います.

Original external subprogram is dc_utils/dcdatetimeadd.f90#dcdatetime_add_ft

operator(+)( diff1, diff2 ) result(result)
Function :
result :type(DC_DIFFTIME)
diff1 :type(DC_DIFFTIME), intent(in)
diff2 :type(DC_DIFFTIME), intent(in)

Original external subprogram is dc_utils/dcdatetimeadd.f90#dcdatetime_add_ff

operator(+)( time, diff ) result(result)
Function :
result :type(DC_DATETIME)
time :type(DC_DATETIME), intent(in)
diff :type(DC_DIFFTIME), intent(in)

Original external subprogram is dc_utils/dcdatetimeadd.f90#dcdatetime_add_tf

operator(-)( time, diff ) result(result)
Function :
result :type(DC_DATETIME)
time :type(DC_DATETIME), intent(in)
diff :type(DC_DIFFTIME), intent(in)

2 つの日時 (DC_DATETIME 型) もしくは 日時差 (DC_DIFFTIME 型)の減算を行います.

Original external subprogram is dc_utils/dcdatetimesub.f90#dcdatetime_sub_tf

operator(-)( diff, sec ) result(result)
Function :
result :type(DC_DIFFTIME)
diff :type(DC_DIFFTIME), intent(in)
sec :integer, intent(in)

Original external subprogram is dc_utils/dcdatetimesub.f90#dcdatetime_sub_fi

operator(-)( diff, sec ) result(result)
Function :
result :type(DC_DIFFTIME)
diff :type(DC_DIFFTIME), intent(in)
sec :real(DP), intent(in)

Original external subprogram is dc_utils/dcdatetimesub.f90#dcdatetime_sub_fd

operator(-)( diff, sec ) result(result)
Function :
result :type(DC_DIFFTIME)
diff :type(DC_DIFFTIME), intent(in)
sec :real, intent(in)

Original external subprogram is dc_utils/dcdatetimesub.f90#dcdatetime_sub_fr

operator(-)( diff1, diff2 ) result(result)
Function :
result :type(DC_DIFFTIME)
diff1 :type(DC_DIFFTIME), intent(in)
diff2 :type(DC_DIFFTIME), intent(in)

Original external subprogram is dc_utils/dcdatetimesub.f90#dcdatetime_sub_ff

operator(-)( time1, time2 ) result(result)
Function :
result :type(DC_DIFFTIME)
time1 :type(DC_DATETIME), intent(in)
time2 :type(DC_DATETIME), intent(in)

Original external subprogram is dc_utils/dcdatetimesub.f90#dcdatetime_sub_tt

operator(/)( diff, denominator ) result(result)
Function :
result :type(DC_DIFFTIME)
diff :type(DC_DIFFTIME), intent(in)
denominator :integer, intent(in)

日時差 diffdenominator で除算した結果を返します.

※ 注意 : 月差を除算すると近似的結果になるおそれがあります

Original external subprogram is dc_utils/dcdatetimediv.f90#dcdatetime_div_fi

operator(/)( diff, denominator ) result(result)
Function :
result :type(DC_DIFFTIME)
diff :type(DC_DIFFTIME), intent(in)
denominator :real(DP), intent(in)

※ 注意 : 月差を除算すると近似的結果になるおそれがあります

Original external subprogram is dc_utils/dcdatetimediv.f90#dcdatetime_div_fd

operator(/)( diff, denominator ) result(result)
Function :
result :type(DC_DIFFTIME)
diff :type(DC_DIFFTIME), intent(in)
denominator :real, intent(in)

※ 注意 : 月差を除算すると近似的結果になるおそれがあります

Original external subprogram is dc_utils/dcdatetimediv.f90#dcdatetime_div_fr

operator(/)( diff1, diff2 ) result(result)
Function :
result :real(DP)
diff1 :type(DC_DIFFTIME), intent(in)
diff2 :type(DC_DIFFTIME), intent(in)

※ 注意 : 月差と日時の混在する除算は近似的結果になるおそれがあります

Original external subprogram is dc_utils/dcdatetimediv.f90#dcdatetime_div_ff

operator(<)( time1, time2 ) result(result)
Function :
result :logical
time1 :type(DC_DATETIME), intent(in)
time2 :type(DC_DATETIME), intent(in)

2 つの引数の日時を比較します. 2 つ目の引数に格納される日時が 1 つ目の引数に格納される日時 よりも進んでいる場合, .true. が返ります.

Original external subprogram is dc_utils/dcdatetimelt.f90#dcdatetime_lt_tt

operator(<)( diff1, diff2 ) result(result)
Function :
result :logical
diff1 :type(DC_DIFFTIME), intent(in)
diff2 :type(DC_DIFFTIME), intent(in)

2 つの引数の日時差を比較します. 2 つ目の引数に格納される日時差が 1 つ目の引数に格納される日時差 よりも大きい場合, .true. が返ります.

Original external subprogram is dc_utils/dcdatetimelt.f90#dcdatetime_lt_ff

operator(<)( diff, factor ) result(result)
Function :
result :logical
diff :type(DC_DIFFTIME), intent(in)
factor :integer, intent(in)

2 つの引数の日時差を比較します. 2 つ目の引数に格納される日時差が 1 つ目の引数に格納される日時差 よりも大きい場合, .true. が返ります.

Original external subprogram is dc_utils/dcdatetimelt.f90#dcdatetime_lt_fi

operator(<)( factor, diff ) result(result)
Function :
result :logical
factor :integer, intent(in)
diff :type(DC_DIFFTIME), intent(in)

2 つの引数の日時差を比較します. 2 つ目の引数に格納される日時差が 1 つ目の引数に格納される日時差 よりも大きい場合, .true. が返ります.

Original external subprogram is dc_utils/dcdatetimelt.f90#dcdatetime_lt_if

operator(<=)( time1, time2 ) result(result)
Function :
result :logical
time1 :type(DC_DATETIME), intent(in)
time2 :type(DC_DATETIME), intent(in)

2 つの引数の日時を比較します. 2 つ目の引数に格納される日時が 1 つ目の引数に格納される日時 よりも進んでいる場合かもしくは等しい場合, .true. が返ります.

Original external subprogram is dc_utils/dcdatetimele.f90#dcdatetime_le_tt

operator(<=)( diff1, diff2 ) result(result)
Function :
result :logical
diff1 :type(DC_DIFFTIME), intent(in)
diff2 :type(DC_DIFFTIME), intent(in)

2 つの引数の日時差を比較します. 2 つ目の引数に格納される日時差が 1 つ目の引数に格納される日時差 よりも大きい場合かもしくは等しい場合, .true. が返ります.

Original external subprogram is dc_utils/dcdatetimele.f90#dcdatetime_le_ff

operator(<=)( diff, factor ) result(result)
Function :
result :logical
diff :type(DC_DIFFTIME), intent(in)
factor :integer, intent(in)

2 つの引数の日時差を比較します. 2 つ目の引数に格納される日時差が 1 つ目の引数に格納される日時差 よりも大きい場合かもしくは等しい場合, .true. が返ります.

Original external subprogram is dc_utils/dcdatetimele.f90#dcdatetime_le_fi

operator(<=)( factor, diff ) result(result)
Function :
result :logical
factor :integer, intent(in)
diff :type(DC_DIFFTIME), intent(in)

2 つの引数の日時差を比較します. 2 つ目の引数に格納される日時差が 1 つ目の引数に格納される日時差 よりも大きい場合かもしくは等しい場合, .true. が返ります.

Original external subprogram is dc_utils/dcdatetimele.f90#dcdatetime_le_if

operator(==)( time1, time2 ) result(result)
Function :
result :logical
time1 :type(DC_DATETIME), intent(in)
time2 :type(DC_DATETIME), intent(in)

2 つの引数の日時を比較します. 1 つ目の引数に格納される日時が 2 つ目の引数に格納される日時 と同じ場合, .true. が返ります.

Original external subprogram is dc_utils/dcdatetimeeq.f90#dcdatetime_eq_tt

operator(==)( diff1, diff2 ) result(result)
Function :
result :logical
diff1 :type(DC_DIFFTIME), intent(in)
diff2 :type(DC_DIFFTIME), intent(in)

2 つの引数の日時差を比較します. 1 つ目の引数に格納される日時差が 2 つ目の引数に格納される日時差 と同じ場合, .true. が返ります.

Original external subprogram is dc_utils/dcdatetimeeq.f90#dcdatetime_eq_ff

operator(==)( i, diff ) result(result)
Function :
result :logical
i :integer, intent(in)
diff :type(DC_DIFFTIME), intent(in)

引数 diff の日時差が i と等しいかどうかを比較します. diff を秒数に換算した値と i とが等しい場合, .true. が返ります.

Original external subprogram is dc_utils/dcdatetimeeq.f90#dcdatetime_eq_if

operator(==)( diff, i ) result(result)
Function :
result :logical
diff :type(DC_DIFFTIME), intent(in)
i :integer, intent(in)

Original external subprogram is dc_utils/dcdatetimeeq.f90#dcdatetime_eq_fi

operator(==)( r, diff ) result(result)
Function :
result :logical
r :real, intent(in)
diff :type(DC_DIFFTIME), intent(in)

引数 diff の日時差が r と等しいかどうかを比較します. diff を秒数に換算した値と r とが等しい場合, .true. が返ります.

Original external subprogram is dc_utils/dcdatetimeeq.f90#dcdatetime_eq_rf

operator(==)( diff, r ) result(result)
Function :
result :logical
diff :type(DC_DIFFTIME), intent(in)
r :real, intent(in)

Original external subprogram is dc_utils/dcdatetimeeq.f90#dcdatetime_eq_fr

operator(==)( d, diff ) result(result)
Function :
result :logical
d :real(DP), intent(in)
diff :type(DC_DIFFTIME), intent(in)

引数 diff の日時差が d と等しいかどうかを比較します. diff を秒数に換算した値と d とが等しい場合, .true. が返ります.

Original external subprogram is dc_utils/dcdatetimeeq.f90#dcdatetime_eq_df

operator(==)( diff, d ) result(result)
Function :
result :logical
diff :type(DC_DIFFTIME), intent(in)
d :real(DP), intent(in)

Original external subprogram is dc_utils/dcdatetimeeq.f90#dcdatetime_eq_fd

operator(>)( time1, time2 ) result(result)
Function :
result :logical
time1 :type(DC_DATETIME), intent(in)
time2 :type(DC_DATETIME), intent(in)

2 つの引数の日時を比較します. 1 つ目の引数に格納される日時が 2 つ目の引数に格納される日時 よりも進んでいる場合, .true. が返ります.

Original external subprogram is dc_utils/dcdatetimegt.f90#dcdatetime_gt_tt

operator(>)( diff1, diff2 ) result(result)
Function :
result :logical
diff1 :type(DC_DIFFTIME), intent(in)
diff2 :type(DC_DIFFTIME), intent(in)

2 つの引数の日時差を比較します. 1 つ目の引数に格納される日時差が 2 つ目の引数に格納される日時差 よりも大きい場合, .true. が返ります.

Original external subprogram is dc_utils/dcdatetimegt.f90#dcdatetime_gt_ff

operator(>)( diff, factor ) result(result)
Function :
result :logical
diff :type(DC_DIFFTIME), intent(in)
factor :integer, intent(in)

2 つの引数の日時差を比較します. 1 つ目の引数に格納される日時差が 2 つ目の引数に格納される日時差 よりも大きい場合, .true. が返ります.

Original external subprogram is dc_utils/dcdatetimegt.f90#dcdatetime_gt_fi

operator(>)( factor, diff ) result(result)
Function :
result :logical
factor :integer, intent(in)
diff :type(DC_DIFFTIME), intent(in)

2 つの引数の日時差を比較します. 1 つ目の引数に格納される日時差が 2 つ目の引数に格納される日時差 よりも大きい場合, .true. が返ります.

Original external subprogram is dc_utils/dcdatetimegt.f90#dcdatetime_gt_if

operator(>=)( time1, time2 ) result(result)
Function :
result :logical
time1 :type(DC_DATETIME), intent(in)
time2 :type(DC_DATETIME), intent(in)

2 つの引数の日時を比較します. 1 つ目の引数に格納される日時が 2 つ目の引数に格納される日時 よりも進んでいる場合かもしくは等しい場合, .true. が返ります.

Original external subprogram is dc_utils/dcdatetimege.f90#dcdatetime_ge_tt

operator(>=)( diff1, diff2 ) result(result)
Function :
result :logical
diff1 :type(DC_DIFFTIME), intent(in)
diff2 :type(DC_DIFFTIME), intent(in)

2 つの引数の日時差を比較します. 1 つ目の引数に格納される日時差が 2 つ目の引数に格納される日時差 よりも大きい場合かもしくは等しい場合, .true. が返ります.

Original external subprogram is dc_utils/dcdatetimege.f90#dcdatetime_ge_ff

operator(>=)( diff, factor ) result(result)
Function :
result :logical
diff :type(DC_DIFFTIME), intent(in)
factor :integer, intent(in)

2 つの引数の日時差を比較します. 1 つ目の引数に格納される日時差が 2 つ目の引数に格納される日時差 よりも大きい場合かもしくは等しい場合, .true. が返ります.

Original external subprogram is dc_utils/dcdatetimege.f90#dcdatetime_ge_fi

operator(>=)( factor, diff ) result(result)
Function :
result :logical
factor :integer, intent(in)
diff :type(DC_DIFFTIME), intent(in)

2 つの引数の日時差を比較します. 1 つ目の引数に格納される日時差が 2 つ目の引数に格納される日時差 よりも大きい場合かもしくは等しい場合, .true. が返ります.

Original external subprogram is dc_utils/dcdatetimege.f90#dcdatetime_ge_if

toChar( time ) result(result)
Function :
result :character(STRING)
time :type(DC_DATETIME), intent(in)

dc_date_types#DC_DATETIME 型変数を文字型変数へ変換して返します. 書式は下記のように JIS X 0301 の完全表記です.

  YYYY-MM-DDThh:mm:ss.sTZD

YYYY は年, MM は月, DD は日, hh は時, mm は分, ss.s は秒, TZD はタイムゾーンを表します.

Original external subprogram is dc_utils/dcdatetimetochar.f90#DCDateTimeToChar

toChar( diff ) result(result)
Function :
result :character(STRING)
diff :type(DC_DIFFTIME), intent(in)

dc_date_types#DC_DIFFTIME 型変数を文字型変数へ変換して返します. 書式は以下のようになります.

  +YYYY-MM-DDThh:mm:ss.s
  -YYYY-MM-DDThh:mm:ss.s

YYYY は年, MM は月, DD は日, hh は時, mm は分, ss.s は秒を表します. ただし, DD は 2 桁を超える場合があります. (dc_date_types#DC_DIFFTIME は X ヶ月後, X 日前, などを表現するため のデータ型なので, 日を月に繰り上げたり, 月を日に繰り下げることを しません. また「年」の情報も持ちません. 1 年の日数や 1 月の日数は dc_date_types#DC_DATETIME 側で決まります).

なお, DCDiffTimeCreate において, 単位を ‘1’ とした場合は無時限時間と 扱うため, 以下のような書式となります.

  ss.s

Original external subprogram is dc_utils/dcdatetimetochar.f90#DCDiffTimeToChar

toCharCal( time, [upcase] ) result(result)
Function :
result :character(TOKEN)
time :type(DC_DATETIME), intent(in)
upcase :logical, intent(in), optional

dc_date_types#DC_DATETIME 型変数の暦を文字型にして返します. 現在サポートされている暦は以下の通りです. 左が暦を示す整数型変数, 右が返る文字列です. upcase に .true. を与えた場合には, 大文字となって返ります.

dc_date_types#CAL_CYCLIC :cyclic
dc_date_types#CAL_NOLEAP :noleap
dc_date_types#CAL_JULIAN :julian
dc_date_types#CAL_GREGORIAN :gregorian

Original external subprogram is dc_utils/dcdatetimetochar.f90#DCDateTimeToCharCal