gsfc.nssdc.cdf.util

Class EpochNative

java.lang.Object

gsfc.nssdc.cdf.util.EpochNative

public class EpochNative
extends java.lang.Object

The Epoch class is a Java wrapper to the CDF epoch handling routines. See Chapter 8 of the CDF C Reference Manual Version 2.6 for details Example:

 
 // Get the milliseconds to Aug 5, 1990 at 5:00
 double ep = Epoch.compute(1990, 8, 5, 5, 0, 0, 0);
 //Get the year, month, day, hour, minutes, seconds, milliseconds for ep
 long times[] = Epoch.breakdown(ep);
 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(Epoch.encode(ep));
 System.out.println(Epoch.encode1(ep));
 System.out.println(Epoch.encode2(ep));
 System.out.println(Epoch.encode3(ep));
 // Print out the date using format
 String format = "<month> <dom.02>, <year> at <hour>:<min>";
 System.out.println(Epoch.encodex(ep,format));
 

Constructor Summary

Constructors

Constructor and Description
EpochNative()

Method Summary

Modifier and Type	Method and Description
static long[]	breakdown(double epoch) Mirrors EPOCHbreakdown from the CDF library.
static double	compute(long year, long month, long day, long hour, long minute, long second, long msec) Mirrors computeEPOCH from the CDF library.
static java.lang.String	encode(double epoch) Mirrors encodeEPOCH from the CDF library.
static java.lang.String	encode1(double epoch) Mirrors encodeEPOCH1 from the CDF library.
static java.lang.String	encode2(double epoch) Mirrors encodeEPOCH2 from the CDF library.
static java.lang.String	encode3(double epoch) Mirrors encodeEPOCH3 from the CDF library.
static java.lang.String	encode4(double epoch) Mirrors encodeEPOCH4 from the CDF library.
static java.lang.String	encodex(double epoch, java.lang.String format) Mirrors encodeEPOCHx from the CDF library.
static double	parse(java.lang.String sEpoch) Mirrors parseEPOCH from CDF library.
static double	parse1(java.lang.String sEpoch) Mirrors parseEPOCH from CDF library.
static double	parse2(java.lang.String sEpoch) Mirrors parseEPOCH from CDF library.
static double	parse3(java.lang.String sEpoch) Mirrors parseEPOCH from CDF library.
static double	parse4(java.lang.String sEpoch) Mirrors parseEPOCH from CDF library.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

EpochNative

public EpochNative()

Method Detail

compute

public static double compute(long year,
                             long month,
                             long day,
                             long hour,
                             long minute,
                             long second,
                             long msec)

Mirrors computeEPOCH from the CDF library. See Section 8.1 of the CDF C Reference Manual Version 2.6 for details

Parameters:

year - the year componment

month - the month componment

day - the day componment

hour - the hour componment

minute - the minute componment

second - the second componment

msec - the millisecond componment

Returns:

a epoch value

breakdown

public static long[] breakdown(double epoch)

Mirrors EPOCHbreakdown from the CDF library. See Section 8.2 of the CDF C Reference Manual Version 2.6 for details

Parameters:

epoch - the epoch, milliseconds since 0AD

Returns:

the day-time componments

encode

public static java.lang.String encode(double epoch)

Mirrors encodeEPOCH from the CDF library. See Section 8.3 of the CDF C Reference Manual Version 2.6 for details

Parameters:

epoch - the epoch, milliseconds since 0AD

Returns:

the epoch in UTC string

encode1

public static java.lang.String encode1(double epoch)

Mirrors encodeEPOCH1 from the CDF library. See Section 8.4 of the CDF C Reference Manual Version 2.6 for details

Parameters:

epoch - the epoch, milliseconds since 0AD

Returns:

the epoch in UTC string

encode2

public static java.lang.String encode2(double epoch)

Mirrors encodeEPOCH2 from the CDF library. See Section 8.5 of the CDF C Reference Manual Version 2.6 for details

Parameters:

epoch - the epoch, milliseconds since 0AD

Returns:

the epoch in UTC string

encode3

public static java.lang.String encode3(double epoch)

Mirrors encodeEPOCH3 from the CDF library. See Section 8.6 of the CDF C Reference Manual Version 2.6 for details

Parameters:

epoch - the epoch, milliseconds since 0AD

Returns:

the epoch in UTC string

encode4

public static java.lang.String encode4(double epoch)

Mirrors encodeEPOCH4 from the CDF library. See Section 8.6 of the CDF C Reference Manual Version 2.6 for details

Parameters:

epoch - the epoch, milliseconds since 0AD

Returns:

the epoch in UTC string

encodex

public static java.lang.String encodex(double epoch,
                                       java.lang.String format)

Mirrors encodeEPOCHx from the CDF library. See Section 8.7 of the CDF C Reference Manual Version 2.6 for details

Parameters:

epoch - the epoch, milliseconds since 0AD

format - the format to encode the string

Returns:

the epoch in UTC string

parse

public static double parse(java.lang.String sEpoch)

Mirrors parseEPOCH from CDF library. See Section 8.8 of the CDF C Reference Manual Version 2.6 for details

Parameters:

sEpoch - the epoch string

Returns:

the epoch

parse1

public static double parse1(java.lang.String sEpoch)

Mirrors parseEPOCH from CDF library. See Section 8.9 of the CDF C Reference Manual Version 2.6 for details

Parameters:

sEpoch - the epoch string

Returns:

the epoch

parse2

public static double parse2(java.lang.String sEpoch)

Mirrors parseEPOCH from CDF library. See Section 8.10 of the CDF C Reference Manual Version 2.6 for details

Parameters:

sEpoch - the epoch string

Returns:

the epoch

parse3

public static double parse3(java.lang.String sEpoch)

Mirrors parseEPOCH from CDF library. See Section 8.11 of the CDF C Reference Manual Version 2.6 for details

Parameters:

sEpoch - the epoch string

Returns:

the epoch

parse4

public static double parse4(java.lang.String sEpoch)

Mirrors parseEPOCH from CDF library. See Section 8.11 of the CDF C Reference Manual Version 2.6 for details

Parameters:

sEpoch - the epoch string

Returns:

the epoch