time.h

Go to the documentation of this file.

/* Copyright (C) 1997-2017 Larry Granroth <larry-granroth@uiowa.edu> 
 *                         Chris Piker <chris-piker@uiowa.edu>
 *                         
 * This file is part of libdas2, the Core Das2 C Library.
 * 
 * Libdas2 is free software; you can redistribute it and/or modify it under
 * the terms of the GNU Lesser General Public License version 2.1 as published
 * by the Free Software Foundation.
 *
 * Libdas2 is distributed in the hope that it will be useful, but WITHOUT ANY
 * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License for
 * more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * version 2.1 along with libdas2; if not, see <http://www.gnu.org/licenses/>. 
 */


#ifndef _das_time_h_
#define _das_time_h_

#include <stdbool.h>
#include <stdint.h>

#ifdef __cplusplus
extern "C" {
#endif

typedef struct das_time_t{

   int year; 
   
   int month; 
   
   int mday; 
   
   int yday; 
   
   int hour;
   
   int minute; 
   
   double second;
   
} das_time;


void dt_null(das_time* pDt);


bool dt_parsetime(const char* string, das_time* dt);


bool dt_now(das_time* pDt);
 

void dt_from_1958(
   unsigned short int daysSince1958, unsigned int msOfDay, das_time* dt
);

int64_t dt_nano_1970(const das_time* dt);

bool dt_in_range(
   const das_time* begin, const das_time* end, const das_time* test
);

void dt_copy(das_time* pDest, const das_time* pSrc);

void dt_set(
   das_time* pDt, int year, int month, int mday, int yday, int hour, 
   int minute, double second
);

int dt_compare(const das_time* pA, const das_time* pB);


double dt_diff(const das_time* pA, const das_time* pB);

char* dt_isoc(char* sBuf, size_t nLen, const das_time* pDt, int nFracSec);

char* dt_isod(char* sBuf, size_t nLen, const das_time* pDt, int nFracSec);


char* dt_dual_str(char* sBuf, size_t nLen, const das_time* pDt, int nFracSec);

      
/* Julian Day at January 1, 1958, 12:00:00 UT */
#define EPOCH 2436205

              
double dt_ttime(const das_time* dt);

void dt_emitt (double tt, das_time* dt);


void dt_tnorm(das_time* dt);

/* return Julian Day number given year, month, and day */
int jday (int year, int month, int day);

#ifdef __cplusplus
}
#endif

#endif /* _das_time_h_ */