Bernese GPS Software Version 5.0 - Bernese GNSS Software

19.6.5.6 Define Time Variables
19.6 User Scripts
With the method RUNBPE::getKeys all predefined time variables of the menu are accessible
in the BPE user scripts. This method can only be used within the environment of the BPE
client. The module ${X}/EXE/Gps Date.pm, on the other hand, can also be used outside
a BPE script (e.g., to start a BPE). The utility allows for all types of date and time
conversions. Date and time strings in different formats are accepted as input. The output
format can be specified separately:
gps_date("-yd 02 143", "-o %X"); # 2002-MAY-31
gps_date("-ymd 2002 5 31","-o COD%W%w"); # COD11685
@time = gps_date("-mjd 52417.5", "-o %Y %j %I"); # Fill three values in an array
scalar(gps_date("-mjd 52417.5","-o %Y %j %I")); # 2002 143 M
gps_date("-yd 02 143","-d +5","-o %y%j"); # 02148
The last line of this example demonstrates the possibility to add or subtract a number of
days (hours or weeks). The important difference to the predefined time variables provided
by the menu is that ${X}/EXE/Gps Date.pm works independently from the session table.
For the complete list of input and output options we refer to the help display shown in
Figure 19.10.
Usage: gps date
[ -hms | -hid TIMSTR ]
[ -h | -d | -w +/-INT ]
[ -o OUTSTR ]
[ -v ]
Supported DATSTR: -ymd .. yy|yyyy mm|mon dd with delimiters [- \s]+
-yd .. yy|yyyy doy|sess|doyid with delimiters [- \s]+
-mjd .. ddddd[.ddddd]
-wd .. wwww d with delimiters [- \s]+
TIMSTR: -hms .. hh|id mm ss with delimiters [-:\s]+
-hid .. hh|id work for hours only
OUTSTR: -o .. any text + spec.chars
Spec. chars: year = %y %Y = [00-99] [1999]
month = %m %b %B %C = [01-12] [jan-dec] [JAN-DEC] [Jan-Dec]
day = %d = [01-31]
doy = %j = [001-365]
dow = %w = [0-6] (Sun=0, Sat=6)
gpsweek = %W = [0-????]
modjul = %J = [?????]
hour,id = %H %I %i = [00-23] [A-X] [a-x] (A=00,..,X=23)
min = %M = [00-59]
sec = %S = [00-59]
dattim = %V %v = [YYYY-MM-DD HH:MM:SS] [YYYY-MON-DD HH:MM:SS]
dat = %X %x = [YYYY-MM-DD] [YYYY-MON-DD]
tim = %Z = [HH-MM-SS]
seconds = %U = seconds from 1.1.1970
spec = %t %n %% = "\tab" "\newline" "%"
pads = %: % = "any pad","blank pad", (default="0 pad")
Figure 19.10: Options for module Gps Date.pm.
Bernese GPS Software Version 5.0 Page 407