Cascade TextLogger: Version 4.0
Prev |  | Next

# time

time -- Specifies the time format for a log or group.

## Syntax

    (time timespec [label ...])

## Arguments

`timespec`

  A string of formatting directives, whose options are as follows:

  `%J` | The day of the week (e.g., `Mon`).
  `%j` | The day of the month `[1-31]`.
  `%M` | The month (e.g., `Jan`).
  `%m` | The month in the year `[1-12]`.
  `%y` | The year in the century (e.g., `96`).
  `%Y` | The year with century (e.g., `1996`).
  `%h` | The hour in the day `[0-23]`.
  `%n` | The minute in the hour `[0-59]`.
  `%z` | The second in the minute `[0-59]`.
  `%Z` | The seconds since Jan 1, 1970.
  `%T` | The tenths of seconds in second (`%z`).
  `%H` | The hundredths of seconds in second (`%z`).
  `%L` | The milliseconds in second (`%z`).
  `%U` | The microseconds in second (`%z`).
  `%N` | The nanoseconds in second (`%z`).
  `%A` | Sets a global default time spec. This default can be changed at any time, including run-time.

`label`

  An optional log or group label.

## Description

The time command lets you specify the time format for any log or group. If no `label` is specified, this command sets a global default value for all logs and groups. Any specific value always overrides the global definition, regardless of the order in the configuration file or when a command is sent.

You can prepend any `printf`-style format modifiers to the time spec field names, as appropriate for the field type. Some of these format modifiers will be ignored (e.g., `%y` and `%Y` ignore format modifiers). The string-type fields, `%J` and `%M`, respond to `%s` modifiers.

| Sub-second fields (`%T`, `%L`, `%U`, `%N`) usually need to be zero-padded to produce readable results, as in `%z.%09N`.

## See Also

log

## Example

        (time  "%02h:%02n:%02z%02H"))
        (time "%j/%m/%y %h:%02n:%02z.%03L" temp press)

Prev | Home | Next
textlog | Up | timestamp

Copyright 1995-2002 by Cogent Real-Time Systems, Inc.