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