dcdatetimetochar.f90 File Reference

Go to the source code of this file.

Functions/Subroutines
character(string) function	dcdatetimetochar (time)
	dc_date_types#DC_DATETIME, dc_date_types#DC_DIFFTIME 型変数の文字変換
character(string) function	dcdifftimetochar (diff)
character(token) function	dcdatetimetocharcal (time, upcase)

Function/Subroutine Documentation

dcdatetimetochar()

character(string) function dcdatetimetochar

(

type(dc_datetime), intent(in)

time

)

dc_date_types#DC_DATETIME, dc_date_types#DC_DIFFTIME 型変数の文字変換

Author

Yasuhiro MORIKAWA

Copyright

Copyright (C) GFD Dennou Club, 2006-2026. All rights reserved.
License is BSD-2-Clause. see COPYRIGHT in detail

このファイルで提供される手続き群は dc_date モジュールにて提供されます。

DC_DATETIME を文字列に変換

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

YYYY-MM-DDThh:mm:ss.sTZD

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

Parameters

[in]

time

変換する日時

Returns

日時の文字列表現

Definition at line 52 of file dcdatetimetochar.f90.

 
  use dc_types, only: string, token, dp
  use dc_string, only: tochar, cprintf, stoa
  use dc_date_generic, only: eval
  use dc_date_types, only: dc_datetime
  use dc_message, only: messagenotify
  implicit none
  character(STRING):: result
  type(DC_DATETIME), intent(in):: time
 
  integer :: year, mon, day, hour, min, csec_len
  real(DP):: sec
  character(TOKEN) :: zone
  character(STRING) :: csec
continue
 
  call eval(time, &
    & year=year, mon=mon, day=day, hour=hour, min=min, sec=sec, zone=zone)
 
  csec = tochar(sec)
  if ( trim(csec) == '-0.' ) csec = '0.'
  do while ( index('123456789.', csec(len_trim(csec):len_trim(csec)) ) == 0 )
    if ( len_trim(csec) < 2 ) exit
    csec = csec(1:len_trim(csec)-1)
  end do
  if (int(sec) > -1 .and. int(sec) < 10) then
    if (len_trim(csec) >= len(csec)) then
      csec = '0' // trim(csec(1:len(csec) - 1))
    else
      csec = '0' // trim(csec)
    end if
  end if
  csec_len = len(trim(adjustl(csec)))
  if (csec(csec_len:csec_len) == '.') csec = csec(1:csec_len-1)
 
  result = cprintf('%04d-%02d-%02dT%02d:%02d:%c%c', &
    & i=(/year, mon, day, hour, min/), &
    & c1=trim(csec), c2=trim(zone))
 

References dc_types::dp, dc_types::string, and dc_types::token.

dcdatetimetocharcal()

character(token) function dcdatetimetocharcal	(	type(dc_datetime), intent(in)	time,
		logical, intent(in), optional	upcase )

DC_DATETIME の暦タイプを文字列に変換

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

Parameters

[in]	time	暦タイプを変換する日時
[in]	upcase	.true. なら大文字で返す

Returns

暦タイプの文字列表現

Definition at line 243 of file dcdatetimetochar.f90.

 
  use dc_types, only: token
  use dc_present, only: present_and_true
  use dc_date_types, only: dc_datetime, &
    & cal_cyclic, cal_noleap, cal_julian, cal_gregorian
  use dc_string, only: toupper
  character(TOKEN) :: result
  type(DC_DATETIME), intent(in):: time
  logical, intent(in), optional:: upcase
continue
  select case( time % caltype )
  case(cal_cyclic)
    result = 'cyclic'
  case(cal_noleap)
    result = 'noleap'
  case(cal_julian)
    result = 'julian'
  case(cal_gregorian)
    result = 'gregorian'
  case default
    result = 'none'
  end select
 
  if ( present_and_true(upcase) ) then
    call toupper(result) ! (inout)
  end if
 

References dc_date_types::cal_cyclic, dc_date_types::cal_gregorian, dc_date_types::cal_julian, dc_date_types::cal_noleap, dc_present::present_and_true(), and dc_types::token.

Here is the call graph for this function:

dcdifftimetochar()

character(string) function dcdifftimetochar

(

type(dc_difftime), intent(in)

diff

)

DC_DIFFTIME を文字列に変換

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

Parameters

[in]

diff

変換する日時差

Returns

日時差の文字列表現

Definition at line 147 of file dcdatetimetochar.f90.

 
  use dc_types, only: string, dp
  use dc_string, only: tochar, cprintf, stoa
  use dc_date_generic, only: eval
  use dc_date_types, only: dc_difftime
  use dc_scaledsec, only: assignment(=)
  implicit none
  character(STRING):: result
  type(DC_DIFFTIME), intent(in):: diff
 
  integer :: year, mon, day, hour, min, csec_len
  real(DP):: sec
  character(STRING) :: csec
  character(1) :: pm
continue
 
  if ( .not. diff % nondim_flag ) then
    call eval(diff, year=year, mon=mon, day=day, hour=hour, min=min, sec=sec)
 
    if ( year < 0 .or. mon < 0 .or. day < 0 .or.  &
      &  hour < 0 .or. min < 0 .or. sec < 0         ) then
      year=abs(year) ; mon=abs(mon) ; day=abs(day)
      hour=abs(hour) ; min=abs(min) ; sec=abs(sec)
      pm = '-'
    else
      pm = '+'
    end if
 
    csec = tochar(sec)
    if ( trim(csec) == '-0.' ) csec = '0.'
    do while ( index('123456789.', csec(len_trim(csec):len_trim(csec)) ) == 0 )
      if ( len_trim(csec) < 2 ) exit
      csec = csec(1:len_trim(csec)-1)
    end do
    if (int(sec) > -1 .and. int(sec) < 10) then
      if (len_trim(csec) >= len(csec)) then
        csec = '0' // trim(csec(1:len(csec) - 1))
      else
        csec = '0' // trim(csec)
      end if
    end if
    csec_len = len(trim(adjustl(csec)))
    if (csec(csec_len:csec_len) == '.') csec = csec(1:csec_len-1)
 
    result = cprintf('%c%04d-%02d-%02dT%02d:%02d:%c', &
      & i=(/year, mon, day, hour, min/), &
      & c1=pm, c2=trim(csec))
  else
    sec = diff % sec
    result = tochar( sec )
  end if
 

References dc_types::dp, and dc_types::string.