4.85 sddstimeconvert

• description: sddstimeconvert does conversions between calendar time in terms of (for example) day, month, and year, and “time-since-epoch”. The latter is the time in seconds since a system-defined reference time (e.g., 0:00 on January 1, 1970).
• examples: Convert column data broken down as day, month, year, and hour to seconds-since-epoch:

  sddstimeconvert input.sdds output.sdds -epoch=column,Time,year=TheYear,month=TheMonth,day=DayOfMonth,hour=HourOfDay

  where TheYear, TheMonth, DayOfMonth, and HourOfDay are the names of the columns in the input file and Time is the column to be created containing the time-since-epoch.

• synopsis:

  sddstimeconvert [inputFile] [outputFile] [-pipe[=input][,output]] [-breakdown={column | parameter},timeName[,year=newName]   [,julianDay=newName][,month=newName][,day=newName][,hour=newName][,text=newName]] [-epoch={column | parameter},newName,year=name
    [,julianDay=name | month=name,day=name],hour=name]

• switches:
  • -pipe[=input][,output] — The standard SDDS Toolkit pipe option.
  • -breakdown={column | parameter},timeName[,year=newName] [,julianDay=newName][,month=newName][,day=newName][,hour=newName] [,text=newName] — Specifies conversion of the column or parameter data named timeName to year, Julian day, month, day, hour, and/or a text string. timeName contains the time expressed as seconds-since-epoch. Any number of these options may be given.
  • -epoch={column | parameter},newName,year=name,
    [julianDay=name | month=name,day=name],hour=name — Specifies conversion of column or parameter data given as year, Julian day or month/day, and hour to seconds-since-epoch, with the result being placed in newName.
• notes: The hour data as used or created by sddstimeconvert contains the floating-point time-of-day in hours. That is, the minutes and seconds are folded into the hour value.

  Year values must be the full four-digit year; e.g., year 99 is not 1999, but rather 99 AD.

• author: M. Borland, ANL/APS.