About Chandra Archive Proposer Instruments & Calibration Newsletters Data Analysis HelpDesk Calibration Database NASA Archives & Centers Chandra Science Links

Skip the navigation links
Last modified: December 2007

URL: http://cxc.harvard.edu/ciao4.0/calgetdate.html
AHELP for CIAO 4.0 calGetDate Context: caldb

Synopsis

Returns the observation start date stored in the CALDB structure.

Syntax

String_Type calGetDate( Caldb_Type cal )

Description

This function returns the start date of the observation stored in the CALDB structure. The returned date may not contain the start time of the observation if the CALDB structure was created from a file; this depends on the format of the DATE-OBS keyword in the file. However, the calGetTime() function is guaranteed to return the start time of the observation.

The caldb module is not available by default; to use it in a S-Lang program, it must be loaded using the S-Lang require() function:

  require("caldb");

Example

  variable cal = calCreateInfo( "img.fits" );
  variable date = calGetDate( cal );
  vmessage( "The observation started on %s", date );

Bugs

See the bugs page for the caldb library on the CIAO website for an up-to-date listing of known bugs.

Last modified: December 2007



The Chandra X-Ray Center (CXC) is operated for NASA by the Smithsonian Astrophysical Observatory.
60 Garden Street, Cambridge, MA 02138 USA.    Email: cxcweb@head.cfa.harvard.edu
Smithsonian Institution, Copyright © 1998-2004. All rights reserved.