Epoch16

java.lang.Object
- gsfc.nssdc.cdf.util.Epoch16

All Implemented Interfaces:: CDFConstants

public class Epoch16
extends java.lang.Object
implements CDFConstants

This class contains the handy utility routines (methods) called by the CDF applications to handle epoch data of CDF's CDF_EPOCH16 data type.

Version:

1.0 Example:

 
 // Get the time, down to picoseconds, for Aug 5, 1990 at 5:0:0.0.0.0
 double[] epoch16 = new double[2];
 double ep = Epoch16.compute(1990, 8, 5, 5, 0, 0, 0, 0, 0, 0, epoch16);
 //Get the year, month, day, hour, minutes, seconds, milliseconds,
 //    microseconds, nanaseconds and picoseconds for epoch16
 long[] times = Epoch16.breakdown(epoch16);
 for (int i=0;i<times.length;i++)
     System.out.print(times[i]+" ");
 System.out.println();
 // Printout the epoch in various formats
 System.out.println(Epoch16.encode(epoch16));
 System.out.println(Epoch16.encode1(epoch16));
 System.out.println(Epoch16.encode2(epoch16));
 System.out.println(Epoch16.encode3(epoch16));
 System.out.println(Epoch16.encode4(epoch16));
 // Print out the date using format
 String format = "<month> <dom.02>, <year> at <hour>:<min>";
 System.out.println(Epoch16.encodex(epoch16,format));

Field Summary
- Fields inherited from interface gsfc.nssdc.cdf.CDFConstants
  AHUFF_COMPRESSION, ALPHAOSF1_DECODING, ALPHAOSF1_ENCODING, ALPHAVMSd_DECODING, ALPHAVMSd_ENCODING, ALPHAVMSg_DECODING, ALPHAVMSg_ENCODING, ALPHAVMSi_DECODING, ALPHAVMSi_ENCODING, ARM_BIG_DECODING, ARM_BIG_ENCODING, ARM_LITTLE_DECODING, ARM_LITTLE_ENCODING, ATTR_, ATTR_EXISTENCE_, ATTR_EXISTS, ATTR_MAXgENTRY_, ATTR_MAXrENTRY_, ATTR_MAXzENTRY_, ATTR_NAME_, ATTR_NAME_TRUNC, ATTR_NUMBER_, ATTR_NUMgENTRIES_, ATTR_NUMrENTRIES_, ATTR_NUMzENTRIES_, ATTR_SCOPE_, BACKWARD_, BACKWARDFILEoff, BACKWARDFILEon, BAD_ALLOCATE_RECS, BAD_ARGUMENT, BAD_ATTR_NAME, BAD_ATTR_NUM, BAD_BLOCKING_FACTOR, BAD_CACHE_SIZE, BAD_CDF_EXTENSION, BAD_CDF_ID, BAD_CDF_NAME, BAD_CDFSTATUS, BAD_CHECKSUM, BAD_COMPRESSION_PARM, BAD_DATA_TYPE, BAD_DECODING, BAD_DIM_COUNT, BAD_DIM_INDEX, BAD_DIM_INTERVAL, BAD_DIM_SIZE, BAD_ENCODING, BAD_ENTRY_NUM, BAD_FNC_OR_ITEM, BAD_FORMAT, BAD_INITIAL_RECS, BAD_MAJORITY, BAD_MALLOC, BAD_NEGtoPOSfp0_MODE, BAD_NUM_DIMS, BAD_NUM_ELEMS, BAD_NUM_STRINGS, BAD_NUM_VARS, BAD_READONLY_MODE, BAD_REC_COUNT, BAD_REC_INTERVAL, BAD_REC_NUM, BAD_SCOPE, BAD_SCRATCH_DIR, BAD_SPARSEARRAYS_PARM, BAD_VAR_NAME, BAD_VAR_NUM, BAD_zMODE, BADDATE_LEAPSECOND_UPDATED, BeginUnixTimeEPOCH, BeginUnixTimeEPOCH16, BLOCKINGFACTOR_TOO_SMALL, BLOCKINGFACTOR_TOO_SMALL2, CANNOT_ALLOCATE_RECORDS, CANNOT_CHANGE, CANNOT_COMPRESS, CANNOT_CONVERT_WIDECHAR, CANNOT_COPY, CANNOT_INSERT_RECORDS, CANNOT_SPARSEARRAYS, CANNOT_SPARSERECORDS, CDF_, CDF_ACCESS_, CDF_ATTR_NAME_LEN, CDF_ATTR_NAME_LEN256, CDF_BYTE, CDF_CACHESIZE_, CDF_CHAR, CDF_CHECKSUM_, CDF_CLOSE_ERROR, CDF_COMPRESSION_, CDF_COPYRIGHT_, CDF_COPYRIGHT_LEN, CDF_CREATE_ERROR, CDF_DECODING_, CDF_DELETE_ERROR, CDF_DOUBLE, CDF_ENCODING_, CDF_EPOCH, CDF_EPOCH16, CDF_EXISTS, CDF_FLOAT, CDF_FORMAT_, CDF_INCREMENT_, CDF_INFO_, CDF_INT1, CDF_INT2, CDF_INT4, CDF_INT8, CDF_INTERNAL_ERROR, CDF_LEAPSECONDLASTUPDATED_, CDF_MAJORITY_, CDF_MAX_DIMS, CDF_MAX_PARMS, CDF_MIN_DIMS, CDF_NAME_, CDF_NAME_TRUNC, CDF_NEGtoPOSfp0_MODE_, CDF_NUMATTRS_, CDF_NUMgATTRS_, CDF_NUMrVARS_, CDF_NUMvATTRS_, CDF_NUMzVARS_, CDF_OK, CDF_OPEN_ERROR, CDF_PATHNAME_LEN, CDF_READ_ERROR, CDF_READONLY_MODE_, CDF_REAL4, CDF_REAL8, CDF_RELEASE_, CDF_SAVE_ERROR, CDF_SCRATCHDIR_, CDF_STATUS_, CDF_STATUSTEXT_LEN, CDF_TIME_TT2000, CDF_UCHAR, CDF_UINT1, CDF_UINT2, CDF_UINT4, CDF_VAR_NAME_LEN, CDF_VAR_NAME_LEN256, CDF_VERSION_, CDF_WARN, CDF_WRITE_ERROR, CDF_zMODE_, CDFwithSTATS_, CHECKSUM_, CHECKSUM_ERROR, CHECKSUM_NOT_ALLOWED, CLOSE_, COLUMN_MAJOR, COMPRESS_CACHESIZE_, COMPRESSION_ERROR, CONFIRM_, CORRUPTED_V2_CDF, CORRUPTED_V3_CDF, CREATE_, CURgENTRY_EXISTENCE_, CURrENTRY_EXISTENCE_, CURzENTRY_EXISTENCE_, DATATYPE_MISMATCH, DATATYPE_SIZE_, DECOMPRESSION_ERROR, DECSTATION_DECODING, DECSTATION_ENCODING, DEFAULT_BYTE_PADVALUE, DEFAULT_CHAR_PADVALUE, DEFAULT_DOUBLE_PADVALUE, DEFAULT_EPOCH_PADVALUE, DEFAULT_EPOCH16_PADVALUE, DEFAULT_FLOAT_PADVALUE, DEFAULT_INT1_PADVALUE, DEFAULT_INT2_PADVALUE, DEFAULT_INT4_PADVALUE, DEFAULT_INT8_PADVALUE, DEFAULT_REAL4_PADVALUE, DEFAULT_REAL8_PADVALUE, DEFAULT_TT2000_PADVALUE, DEFAULT_UCHAR_PADVALUE, DEFAULT_UINT1_PADVALUE, DEFAULT_UINT2_PADVALUE, DEFAULT_UINT4_PADVALUE, DELETE_, DID_NOT_COMPRESS, EMPTY_COMPRESSED_CDF, END_OF_VAR, EPOCH_STRING_LEN, EPOCH_STRING_LEN_EXTEND, EPOCH1_STRING_LEN, EPOCH1_STRING_LEN_EXTEND, EPOCH2_STRING_LEN, EPOCH2_STRING_LEN_EXTEND, EPOCH3_STRING_LEN, EPOCH3_STRING_LEN_EXTEND, EPOCH4_STRING_LEN, EPOCH4_STRING_LEN_EXTEND, EPOCHx_FORMAT_MAX, EPOCHx_STRING_MAX, FILLED_TT2000_VALUE, FORCED_PARAMETER, FUNCTION_NOT_SUPPORTED, gENTRY_, gENTRY_DATA_, gENTRY_DATASPEC_, gENTRY_DATATYPE_, gENTRY_EXISTENCE_, gENTRY_NUMELEMS_, GET_, GETCDFCHECKSUM_, GETCDFFILEBACKWARD_, GETCDFVALIDATE_, GETLEAPSECONDSENVVAR_, GLOBAL_SCOPE, GZIP_COMPRESSION, HOST_DECODING, HOST_ENCODING, HP_DECODING, HP_ENCODING, HUFF_COMPRESSION, IA64VMSd_DECODING, IA64VMSd_ENCODING, IA64VMSg_DECODING, IA64VMSg_ENCODING, IA64VMSi_DECODING, IA64VMSi_ENCODING, IBM_PC_OVERFLOW, IBMPC_DECODING, IBMPC_ENCODING, IBMRS_DECODING, IBMRS_ENCODING, ILLEGAL_EPOCH_FIELD, ILLEGAL_EPOCH_VALUE, ILLEGAL_FOR_SCOPE, ILLEGAL_IN_zMODE, ILLEGAL_ON_V1_CDF, ILLEGAL_TT2000_VALUE, IS_A_NETCDF, LIB_COPYRIGHT_, LIB_INCREMENT_, LIB_RELEASE_, LIB_subINCREMENT_, LIB_VERSION_, MAC_DECODING, MAC_ENCODING, MD5_CHECKSUM, MULTI_FILE, MULTI_FILE_FORMAT, NA_FOR_VARIABLE, NEGATIVE_FP_ZERO, NEGtoPOSfp0off, NEGtoPOSfp0on, NETWORK_DECODING, NETWORK_ENCODING, NeXT_DECODING, NeXT_ENCODING, NO_ATTR_SELECTED, NO_CDF_SELECTED, NO_CHECKSUM, NO_COMPRESSION, NO_DELETE_ACCESS, NO_ENTRY_SELECTED, NO_MORE_ACCESS, NO_PADVALUE_SPECIFIED, NO_SPARSEARRAYS, NO_SPARSERECORDS, NO_STATUS_SELECTED, NO_SUCH_ATTR, NO_SUCH_CDF, NO_SUCH_ENTRY, NO_SUCH_RECORD, NO_SUCH_VAR, NO_VAR_SELECTED, NO_VARS_IN_CDF, NO_WRITE_ACCESS, NONE_CHECKSUM, NOT_A_CDF, NOT_A_CDF_OR_NOT_SUPPORTED, NOVARY, NULL_, OPEN_, OPTIMAL_ENCODING_TREES, OTHER_CHECKSUM, PAD_SPARSERECORDS, PPC_DECODING, PPC_ENCODING, PRECEEDING_RECORDS_ALLOCATED, PREV_SPARSERECORDS, PUT_, READ_ONLY_DISTRIBUTION, READ_ONLY_MODE, READONLYoff, READONLYon, rENTRY_, rENTRY_DATA_, rENTRY_DATASPEC_, rENTRY_DATATYPE_, rENTRY_EXISTENCE_, rENTRY_NAME_, rENTRY_NUMELEMS_, rENTRY_NUMSTRINGS_, rENTRY_STRINGSDATA_, RLE_COMPRESSION, RLE_OF_ZEROs, ROW_MAJOR, rVAR_, rVAR_ALLOCATEBLOCK_, rVAR_ALLOCATEDFROM_, rVAR_ALLOCATEDTO_, rVAR_ALLOCATERECS_, rVAR_BLOCKINGFACTOR_, rVAR_CACHESIZE_, rVAR_COMPRESSION_, rVAR_DATA_, rVAR_DATASPEC_, rVAR_DATATYPE_, rVAR_DIMVARYS_, rVAR_EXISTENCE_, rVAR_HYPERDATA_, rVAR_INITIALRECS_, rVAR_MAXallocREC_, rVAR_MAXREC_, rVAR_NAME_, rVAR_nINDEXENTRIES_, rVAR_nINDEXLEVELS_, rVAR_nINDEXRECORDS_, rVAR_NUMallocRECS_, rVAR_NUMBER_, rVAR_NUMELEMS_, rVAR_NUMRECS_, rVAR_PADVALUE_, rVAR_RECORDS_, rVAR_RECORDS_RENUMBER_, rVAR_RECVARY_, rVAR_RESERVEPERCENT_, rVAR_SEQDATA_, rVAR_SEQPOS_, rVAR_SPARSEARRAYS_, rVAR_SPARSERECORDS_, rVARs_CACHESIZE_, rVARs_DIMCOUNTS_, rVARs_DIMINDICES_, rVARs_DIMINTERVALS_, rVARs_DIMSIZES_, rVARs_MAXREC_, rVARs_NUMDIMS_, rVARs_RECCOUNT_, rVARs_RECDATA_, rVARs_RECINTERVAL_, rVARs_RECNUMBER_, SAVE_, SCRATCH_CREATE_ERROR, SCRATCH_DELETE_ERROR, SCRATCH_READ_ERROR, SCRATCH_WRITE_ERROR, SELECT_, SGi_DECODING, SGi_ENCODING, SINGLE_FILE, SINGLE_FILE_FORMAT, SOME_ALREADY_ALLOCATED, STAGE_CACHESIZE_, STATUS_TEXT_, STRING_NOT_UTF8_ENCODING, STRINGDELIMITER, SUN_DECODING, SUN_ENCODING, TOO_MANY_PARMS, TOO_MANY_VARS, TRY_TO_READ_NONSTRING_DATA, TT2000_0_STRING_LEN, TT2000_1_STRING_LEN, TT2000_2_STRING_LEN, TT2000_3_STRING_LEN, TT2000_4_STRING_LEN, TT2000_CDF_MAYNEEDUPDATE, TT2000_TIME_ERROR, TT2000_USED_OUTDATED_TABLE, UNABLE_TO_PROCESS_CDF, UNKNOWN_COMPRESSION, UNKNOWN_SPARSENESS, UNSUPPORTED_OPERATION, VALIDATE_, VALIDATEFILEoff, VALIDATEFILEon, VAR_ALREADY_CLOSED, VAR_CLOSE_ERROR, VAR_CREATE_ERROR, VAR_DELETE_ERROR, VAR_EXISTS, VAR_NAME_TRUNC, VAR_OPEN_ERROR, VAR_READ_ERROR, VAR_SAVE_ERROR, VAR_WRITE_ERROR, VARIABLE_SCOPE, VARY, VAX_DECODING, VAX_ENCODING, VIRTUAL_RECORD_DATA, zENTRY_, zENTRY_DATA_, zENTRY_DATASPEC_, zENTRY_DATATYPE_, zENTRY_EXISTENCE_, zENTRY_NAME_, zENTRY_NUMELEMS_, zENTRY_NUMSTRINGS_, zENTRY_STRINGSDATA_, ZLIB_COMPRESS_ERROR, ZLIB_UNCOMPRESS_ERROR, zMODEoff, zMODEon1, zMODEon2, zVAR_, zVAR_ALLOCATEBLOCK_, zVAR_ALLOCATEDFROM_, zVAR_ALLOCATEDTO_, zVAR_ALLOCATERECS_, zVAR_BLOCKINGFACTOR_, zVAR_CACHESIZE_, zVAR_COMPRESSION_, zVAR_DATA_, zVAR_DATASPEC_, zVAR_DATATYPE_, zVAR_DIMCOUNTS_, zVAR_DIMINDICES_, zVAR_DIMINTERVALS_, zVAR_DIMSIZES_, zVAR_DIMVARYS_, zVAR_EXISTENCE_, zVAR_HYPERDATA_, zVAR_INITIALRECS_, zVAR_MAXallocREC_, zVAR_MAXREC_, zVAR_NAME_, zVAR_nINDEXENTRIES_, zVAR_nINDEXLEVELS_, zVAR_nINDEXRECORDS_, zVAR_NUMallocRECS_, zVAR_NUMBER_, zVAR_NUMDIMS_, zVAR_NUMELEMS_, zVAR_NUMRECS_, zVAR_PADVALUE_, zVAR_RECCOUNT_, zVAR_RECINTERVAL_, zVAR_RECNUMBER_, zVAR_RECORDS_, zVAR_RECORDS_RENUMBER_, zVAR_RECVARY_, zVAR_RESERVEPERCENT_, zVAR_SEQDATA_, zVAR_SEQPOS_, zVAR_SPARSEARRAYS_, zVAR_SPARSERECORDS_, zVARs_CACHESIZE_, zVARs_MAXREC_, zVARs_RECDATA_, zVARs_RECNUMBER_

Constructor Summary

Constructors
Constructor and Description

Epoch16()

Constructors
Constructor and Description
`Epoch16()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static long[]`	`breakdown(java.lang.Object epoch)` Breaks an EPOCH16 value down into its component parts.
`static double`	`compute(long year, long month, long day, long hour, long minute, long second, long msec, long usec, long nsec, long psec, java.lang.Object epoch)` Computes an EPOCH16 value based on its component parts.
`static java.lang.String`	`encode(java.lang.Object epoch)` Converts an EPOCH16 value into a readable date/time string.
`static java.lang.String`	`encode1(java.lang.Object epoch)` Converts an EPOCH16 value into a readable date/time string.
`static java.lang.String`	`encode2(java.lang.Object epoch)` Converts an EPOCH16 value into a readable date/time string.
`static java.lang.String`	`encode3(java.lang.Object epoch)` Converts an EPOCH16 value into a readable date/time string.
`static java.lang.String`	`encode4(java.lang.Object epoch)` Converts an EPOCH16 value into a readable date/time, ISO8601 string.
`static java.lang.String`	`encodex(java.lang.Object epoch, java.lang.String formatString)` Converts an EPOCH16 value into a readable date/time string using the specified format.
`static double`	`Epoch16toUnixTime(double[] epoch)` Converts an EPOCH16 value to a unix time of a double value (seconds from 1970-01-01 00:00:00 UTC).
`static java.lang.Object`	`parse(java.lang.String inString)` This function parses an input date/time string and returns an EPOCH16 value.
`static java.lang.Object`	`parse1(java.lang.String inString)` This function parses an input date/time string and returns an EPOCH16 value.
`static java.lang.Object`	`parse2(java.lang.String inString)` This function parses an input date/time string and returns an EPOCH16 value.
`static java.lang.Object`	`parse3(java.lang.String inString)` This function parses an input date/time string and returns an EPOCH16 value.
`static java.lang.Object`	`parse4(java.lang.String inString)` This function parses an input date/time, ISO8601 string and returns an EPOCH16 value.
`static java.lang.String`	`toEncode(double[] epoch)` Converts an EPOCH object into a scalar or array of readable date/time string.
`static java.lang.String`	`toEncode(double[] epoch, int style)` Converts an EPOCH16 value into a readable date/time string.
`static java.lang.Object`	`toEncode(java.lang.Object epoch)` Converts an EPOCH object into a scalar or array of readable date/time string.
`static java.lang.Object`	`toEncode(java.lang.Object epoch, long size)` Converts an EPOCH object into a scalar or array(s) of readable date/time string.
`static double[]`	`toParse(java.lang.String inString)` This function parses a date/time string and returns an EPOCH16 value.
`static double[]`	`UnixTimetoEpoch16(double unixTime)` Converts a unix time of a double value (seconds from 1970-01-01 00:00:00 UTC) to an EPOCH16 value.

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - Epoch16
```
public Epoch16()
```
- Method Detail
  - toParse
```
public static double[] toParse(java.lang.String inString)
                        throws CDFException
```
    This function parses a date/time string and returns an EPOCH16 value. The string format must be exactly as one of the followings (which are made from the corresponding encoding methods).
```
 Style 0 - 
 Format:   dd-mmm-yyyy hh:mm:ss.mmm.uuu.nnn.ppp
 Examples:  1-Apr-1990 03:05:02.000.000.000.000
           10-Oct-1993 23:45:49.999.999.999.999

 Style 1 - 
 Format:   yyyymmdd.ttttttttttttttt
 Examples: 19900401.365889312345678
           19931010.000000000000000

 Style 2 - 
 Format:   yyyymmddhhmmss
 Examples: 19900401030502
           19931010234549

 Style 3 - 
 Format:   yyyy-mm-ddThh:mm:ss.mmm.uuu.nnn.pppZ
 Examples: 1990-04-01T03:05:02.000.000.000.000Z
           1993-10-10T23:45:49.999.999.999.999Z

 Style 4 - 
 Format:   yyyy-mm-ddThh:mm:ss.mmmuuunnnppp
 Examples: 1990-04-01T03:05:02.000000000000
           1993-10-10T23:45:49.999999999999

 
```
    Parameters:
    
    inString - the epoch in string representation
    
    Returns:
    
    the value of the epoch represented by inString or null if null or an empty string is detected
    
    Throws:
    
    CDFException - if a bad epoch value is passed in inStrings
  - parse
```
public static java.lang.Object parse(java.lang.String inString)
                              throws CDFException
```
    This function parses an input date/time string and returns an EPOCH16 value. The format must be exactly as shown below. Month abbreviations may be in any case and are always the first three letters of the month.
```
 Format:          dd-mmm-yyyy hh:mm:ss.ccc.mmm.nnn.ppp
 Examples:         1-Apr-1990 03:05:02.000.000.000.000
                  10-Oct-1993 23:45:49.999.999.999.999
 
```
    The expected format is the same as that produced by encode.
    Parameters:
    
    inString - the epoch in string representation
    
    Returns:
    
    the value of the epoch represented by inString
    
    Throws:
    
    CDFException - if a bad epoch value is passed in inString
  - parse1
```
public static java.lang.Object parse1(java.lang.String inString)
                               throws CDFException
```
    This function parses an input date/time string and returns an EPOCH16 value. The format must be exactly as shown below. Note that if there are less than 15 digits after the decimal point, zeros (0's) are assumed for the missing digits.
```
 Format:            yyyymmdd.ttttttttttttttt
 Examples:          19950508.000000000000000
                    19671231.58      (== 19671213.580000000000000)
 
```
    The expected format is the same as that produced by encode1.
    Parameters:
    
    inString - the epoch in string representation
    
    Returns:
    
    the value of the epoch represented by inString
    
    Throws:
    
    CDFException - if a bad epoch value is passed in inString
  - parse2
```
public static java.lang.Object parse2(java.lang.String inString)
                               throws CDFException
```
    This function parses an input date/time string and returns an EPOCH16 value. The format must be exactly as shown below.
```
 Format:           yyyymmddhhmmss
 Examples:         19950508000000
                   19671231235959
 
```
    The expected format is the same as that produced by encode2.
    Parameters:
    
    inString - the epoch in string representation
    
    Returns:
    
    the value of the epoch represented by inString
    
    Throws:
    
    CDFException - if a bad epoch value is passed in inString
  - parse3
```
public static java.lang.Object parse3(java.lang.String inString)
                               throws CDFException
```
    This function parses an input date/time string and returns an EPOCH16 value. The format must be exactly as shown below.
```
 Format:            yyyy-mm-ddThh:mm:ss.ccc.mmm.nnn.pppZ
 Examples:          1990-04-01T03:05:02.000.000.000.000Z
                    1993-10-10T23:45:49.999.999.999.999Z
 
```
    The expected format is the same as that produced by encode3.
    Parameters:
    
    inString - the epoch in string representation
    
    Returns:
    
    the value of the epoch represented by inString
    
    Throws:
    
    CDFException - if a bad epoch value is passed in inString
  - parse4
```
public static java.lang.Object parse4(java.lang.String inString)
                               throws CDFException
```
    This function parses an input date/time, ISO8601 string and returns an EPOCH16 value. The format must be exactly as shown below.
```
 Format:            yyyy-mm-ddThh:mm:ss.cccmmmnnnppp
 Examples:          1990-04-01T03:05:02.000000000000
                    1993-10-10T23:45:49.999999999999
 
```
    The expected format is the same as that produced by encode4.
    Parameters:
    
    inString - the epoch in string representation
    
    Returns:
    
    the value of the epoch represented by inString
    
    Throws:
    
    CDFException - if a bad epoch value is passed in inString
  - toEncode
```
public static java.lang.String toEncode(double[] epoch,
                                        int style)
```
    Converts an EPOCH16 value into a readable date/time string. Depending on the encoding style, it can present the string to one of the following forms:
```
 For style 0: 
 Format:    dd-mmm-yyyy hh:mm:ss.ccc.uuu.nnn.ppp
 Examples:  01-Apr-1990 03:05:02.000.111.222.333
            10-Oct-1993 23:45:49.999.999.999.999
 
 For style 1: 
 Format:    yyyymmdd.ttttttt
 Examples:  19950508.0000000
            19671231.58      (== 19671213.5800000)
  
 For style 2: 
 Format:    yyyymmddhhmmss
 Examples:  19900401030502 
            19931010234549
  
 For style 3: 
 Format:    yyyymmddThh:mm:ss.ccc.uuu.nnn.pppZ
 Examples:  19900401T03:05:02.000.111.222.333Z
            19931010T23:45:49.999.999.999.999Z
      
 For style 4: 
 Format:    yyyymmddThh:mm:ss.cccuuunnnppp
 Examples:  19900401T03:05:02.000111222333
            19931010T23:45:49.999999999999
 The default style, if the style is invalid.
      
 
```
    Parameters:
    
    epoch - the epoch value
    
    style - the encoding style
    
    Returns:
    
    A string representation of the epoch
  - toEncode
```
public static java.lang.Object toEncode(java.lang.Object epoch)
```
    Converts an EPOCH object into a scalar or array of readable date/time string. Each string is presented in the following ISO 8601 form:
```
 Format:    yyyymmddThh:mm:ss.cccuuunnnppp
 Examples:  19900401T03:05:02.000111222333
            19931010T23:45:49.999999999999

 
```
    Parameters:
    
    epoch - the epoch object
    
    Returns:
    
    A string or array of strings representation of the epoch
  - toEncode
```
public static java.lang.String toEncode(double[] epoch)
```
    Converts an EPOCH object into a scalar or array of readable date/time string. Each string is presented in the following ISO 8601 form:
```
 Format:    yyyymmddThh:mm:ss.cccuuunnnppp
 Examples:  19900401T03:05:02.000111222333
            19931010T23:45:49.999999999999

 
```
    Parameters:
    
    epoch - the epoch object
    
    Returns:
    
    A string or array of strings representation of the epoch
  - toEncode
```
public static java.lang.Object toEncode(java.lang.Object epoch,
                                        long size)
```
    Converts an EPOCH object into a scalar or array(s) of readable date/time string. Each string is presented in the following ISO 8601 form:
```
 Format:    yyyymmddThh:mm:ss.cccuuunnnppp
 Examples:  19900401T03:05:02.000111222333
            19931010T23:45:49.999999999999

 
```
    Parameters:
    
    epoch - the epoch object
    
    size - the number of CDF_EPOCH16 data
    
    Returns:
    
    A string or array(s) of strings representation of the epoch
  - Epoch16toUnixTime
```
public static double Epoch16toUnixTime(double[] epoch)
```
    Converts an EPOCH16 value to a unix time of a double value (seconds from 1970-01-01 00:00:00 UTC). The unix time will have a time resolution of microseconds at its fraction part. Note: As EPOCH16 have a higher time resolution than the unix time. The conversion might not precisely preserve the microseconds due to the floating point presentation.
    
    Parameters:
    
    epoch - the epoch16 value (2-double)
    
    Returns:
    
    A unix time value
  - UnixTimetoEpoch16
```
public static double[] UnixTimetoEpoch16(double unixTime)
```
    Converts a unix time of a double value (seconds from 1970-01-01 00:00:00 UTC) to an EPOCH16 value. The unix time can have a time resolution in microseconds at its fraction part. Note: As EPOCH16 have a higher time resolution than the unix time. The conversion might not precisely preserve the microseconds due to the floating point presentation.
    
    Parameters:
    
    unixTime - the unix time value
    
    Returns:
    
    An EPOCH16 value (2-double)
  - encode
```
public static java.lang.String encode(java.lang.Object epoch)
```
    Converts an EPOCH16 value into a readable date/time string.
```
 Format:            dd-mmm-yyyy hh:mm:ss.ccc.mmm.nnn.ppp
 Examples:          01-Apr-1990 03:05:02.000.000.000.000
                    10-Oct-1993 23:45:49.999.999.999.999
 
```
    This format is the same as that expected by parse.
    Parameters:
    
    epoch - the epoch value
    
    Returns:
    
    A string representation of the epoch
  - encode1
```
public static java.lang.String encode1(java.lang.Object epoch)
```
    Converts an EPOCH16 value into a readable date/time string.
```
 Format:            yyyymmdd.ttttttttttttttt
 Examples:          19900401.365889312341234
                    19611231.000000000000000
 
```
    This format is the same as that expected by parse1.
    Parameters:
    
    epoch - the epoch value
    
    Returns:
    
    A string representation of the epoch
  - encode2
```
public static java.lang.String encode2(java.lang.Object epoch)
```
    Converts an EPOCH16 value into a readable date/time string.
```
 Format:          yyyymmddhhmmss
 Examples:        19900401235959
                  19611231000000
 
```
    This format is the same as that expected by parse2.
    Parameters:
    
    epoch - the epoch value
    
    Returns:
    
    A string representation of the epoch
  - encode3
```
public static java.lang.String encode3(java.lang.Object epoch)
```
    Converts an EPOCH16 value into a readable date/time string.
```
 Format:            yyyy-mm-ddThh:mm:ss.ccc.mmm.nnn.pppZ
 Examples:          1990-04-01T03:05:02.000.000.000.000Z
                    1993-10-10T23:45:49.999.999.999.999Z
 
```
    This format is the same as that expected by parse3.
    Parameters:
    
    epoch - the epoch value
    
    Returns:
    
    A string representation of the epoch
  - encode4
```
public static java.lang.String encode4(java.lang.Object epoch)
```
    Converts an EPOCH16 value into a readable date/time, ISO8601 string.
```
 Format:            yyyy-mm-ddThh:mm:ss.cccmmmnnnppp
 Examples:          1990-04-01T03:05:02.000000000000
                    1993-10-10T23:45:49.999999999999
 
```
    This format is the same as that expected by parse4.
    Parameters:
    
    epoch - the epoch value
    
    Returns:
    
    A string representation of the epoch
  - encodex
```
public static java.lang.String encodex(java.lang.Object epoch,
                                       java.lang.String formatString)
```
    Converts an EPOCH16 value into a readable date/time string using the specified format. See the C Reference Manual section 8.7 for details
    
    Parameters:
    
    epoch - the epoch value
    
    formatString - a string representing the desired format of the epoch
    
    Returns:
    
    A string representation of the epoch according to formatString
  - compute
```
public static double compute(long year,
                             long month,
                             long day,
                             long hour,
                             long minute,
                             long second,
                             long msec,
                             long usec,
                             long nsec,
                             long psec,
                             java.lang.Object epoch)
                      throws CDFException
```
    Computes an EPOCH16 value based on its component parts.
    
    Parameters:
    
    year - the year
    
    month - the month
    
    day - the day
    
    hour - the hour
    
    minute - the minute
    
    second - the second
    
    msec - the milliseconds
    
    usec - the microseconds
    
    nsec - the nanoseconds
    
    psec - the picoseconds
    
    epoch - returned epoch value
    
    Returns:
    
    a double value which indicates whether the operation is successful
    
    Throws:
    
    CDFException - an ILLEGAL_EPOCH_FIELD if an illegal component value is detected.
  - breakdown
```
public static long[] breakdown(java.lang.Object epoch)
```
    Breaks an EPOCH16 value down into its component parts.
    
    Parameters:
    
    epoch - the epoch value to break down
    
    Returns:
    
    an array containing the epoch parts:
    
    Index Part
    
    0 year
    
    1 month
    
    2 day
    
    3 hour
    
    4 minute
    
    5 second
    
    6 msec
    
    7 usec
    
    8 nsec
    
    9 psec

Index	Part
0	year
1	month
2	day
3	hour
4	minute
5	second
6	msec
7	usec
8	nsec
9	psec

Class Epoch16

Field Summary

Fields inherited from interface gsfc.nssdc.cdf.CDFConstants

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Epoch16

Method Detail

toParse

parse

parse1

parse2

parse3

parse4

toEncode

toEncode

toEncode

toEncode

Epoch16toUnixTime

UnixTimetoEpoch16

encode

encode1

encode2

encode3

encode4

encodex

compute

breakdown