date
Prev | Orchestra Opcodes and Operators | Next

## date

date — Returns the number seconds since a base date.

## Description

Plugin opcode in cs_date.

Returns the number seconds since a base date, using the operating system's clock. The base is 1 January 1970 for Csound using doubles, and 1 January 2010 for versions using floats. On operating systemms with sufficient resolution the date includes fractional seconds.

## Syntax

    ir[, inano] date

    kr[, knano] date

## Initialization and Performance

ir -- value at i-time, of the system clock in seconds since the start of the epoch.

kr -- value at k-time, of the system clock in seconds since the start of the epoch.

inano -- value at i-time of the nanoseconds since last second tick.

knano -- value at k-time of the nanoseconds since last second tick.

Note that the base date was originally 1970 but since verson 5.14 it has been changed as single precission floating point numbers are insufficient to indicate changes.

The optional answer and resolution including fractions of a second introduced in version 6.07.

## Examples

Here is an example of the date opcode. It uses the file date.csd.

Example 204. Example of the date opcode.

    <CsoundSynthesizer>
    <CsOptions>
    ; Select audio/midi flags here according to platform
    ; Audio out   Audio in
    -odac           -iadc    ;;;RT audio I/O
    ; For Non-realtime ouput leave only the line below:
    ; -o date.wav -W ;;; for file output any platform
    </CsOptions>
    <CsInstruments>
    instr 1
          ii,ij date
          print ii
          print ij
          Sa dates ii
          prints Sa
          Ss dates -1
          prints Ss
          St dates 1
          prints St
    endin

    </CsInstruments>

    <CsScore>
    i 1 0 1
    e
    </CsScore>

    </CsoundSynthesizer>

Its output should include lines like this:

    instr 1:  ii = 1447337826.778
    instr 1:  ij = 778279830.000
    Thu Nov 12 14:17:07 2015
    Thu Nov 12 14:17:06 2015
    Thu Jan  1 01:00:01 1970

## See also

Time Reading

## Credits

Author: John ffitch
University of Bath/Codemist Ltd.
Bath, UK
December 2006

New in Csound version 5.05

Changed in Csound version 5.14

Prev | Up | Next
dam | Home | dates