org.paces.Stata.Utilities

Class StataXTTS

java.lang.Object

org.paces.Stata.Utilities.StataXTTS

public class StataXTTS
extends java.lang.Object

Class and Methods to convert Java Date, Time, and Timestamp objects to Stata representations. This class and the methods should be tested a bit more before use in a production environment.

Version:

%G%

Author:

Billy Buchanan

Field Summary

Fields

Modifier and Type	Field and Description
private java.time.Instant	JAVAEPOCH Constant for the Java Epoch date
private java.time.Instant	STATAEPOCH Constant for the Stata Epoch date
private java.time.ZoneId	zid System default zone ID

Constructor Summary

Constructors

Constructor and Description
StataXTTS()

Method Summary

Modifier and Type	Method and Description
static void	main(java.lang.String[] args)
java.lang.String	stringArrayToStataDate(java.lang.String[] toStata) Method that returns a String formatted to be included in Stata date function like date(retval, "YMDHms")
java.lang.Double	toStata(java.sql.Date datetime) Method to convert Java Dates to Stata Dates
java.lang.String[]	toStata(java.nio.file.attribute.FileTime datetime) Method to convert Java Timestamps to Stata Datetimes
java.lang.Double	toStata(java.sql.Time datetime) Method to convert Java Times to Stata Datetimes
java.lang.Double	toStata(java.sql.Timestamp datetime) Method to convert Java Timestamps to Stata Datetimes

Methods inherited from class java.lang.Object

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

Field Detail

zid

private final java.time.ZoneId zid

System default zone ID

STATAEPOCH

private final java.time.Instant STATAEPOCH

Constant for the Stata Epoch date

JAVAEPOCH

private final java.time.Instant JAVAEPOCH

Constant for the Java Epoch date

Constructor Detail

StataXTTS

public StataXTTS()

Method Detail

main

public static void main(java.lang.String[] args)

toStata

public java.lang.Double toStata(java.sql.Date datetime)

Method to convert Java Dates to Stata Dates

Parameters:

datetime - A date object to convert to a Stata datetime value

Returns:

Double precision milliseconds elapsed since 01jan1960

toStata

public java.lang.Double toStata(java.sql.Time datetime)

Method to convert Java Times to Stata Datetimes

Parameters:

datetime - A time object returned from the JDBC query

Returns:

Double precision milliseconds elapsed since 01jan1960

toStata

public java.lang.Double toStata(java.sql.Timestamp datetime)

Method to convert Java Timestamps to Stata Datetimes

Parameters:

datetime - A timestamp object returned from the JDBC query

Returns:

A long integer containing the number of milliseconds past the Stata epoch (01jan1960) precision milliseconds elapsed since 01jan1960. The value can be displayed correctly in Stata using the %tc format.

toStata

public java.lang.String[] toStata(java.nio.file.attribute.FileTime datetime)

Method to convert Java Timestamps to Stata Datetimes

Parameters:

datetime - A timestamp object returned from the JDBC query

Returns:

A long integer containing the number of milliseconds past the Stata epoch (01jan1960) precision milliseconds elapsed since 01jan1960. The value can be displayed correctly in Stata using the %tc format.

stringArrayToStataDate

public java.lang.String stringArrayToStataDate(java.lang.String[] toStata)

Method that returns a String formatted to be included in Stata date function like date(retval, "YMDHms")

Parameters:

toStata - A string array created by the toStata method used for FileTime objects

Returns:

A String with the date and time prepared for use in Stata.