SdtDateStorageFormat

Inheritance: java.lang.Object

public class SdtDateStorageFormat

Specifies how the date for a date SDT is stored/retrieved when the SDT is bound to an XML node in the document’s data store.

Examples:

Shows how to prompt the user to enter a date with a structured document tag.


 Document doc = new Document();

 // Insert a structured document tag that prompts the user to enter a date.
 // In Microsoft Word, this element is known as a "Date picker content control".
 // When we click on the arrow on the right end of this tag in Microsoft Word,
 // we will see a pop up in the form of a clickable calendar.
 // We can use that popup to select a date that the tag will display.
 StructuredDocumentTag sdtDate = new StructuredDocumentTag(doc, SdtType.DATE, MarkupLevel.INLINE);

 // Display the date, according to the Saudi Arabian Arabic locale.
 sdtDate.setDateDisplayLocale(1025);

 // Set the format with which to display the date.
 sdtDate.setDateDisplayFormat("dd MMMM, yyyy");
 sdtDate.setDateStorageFormat(SdtDateStorageFormat.DATE_TIME);

 // Display the date according to the Hijri calendar.
 sdtDate.setCalendarType(SdtCalendarType.HIJRI);

 // Before the user chooses a date in Microsoft Word, the tag will display the text "Click here to enter a date.".
 // According to the tag's calendar, set the "FullDate" property to get the tag to display a default date.
 Calendar cal = Calendar.getInstance();
 cal.set(1440, 10, 20);
 sdtDate.setFullDate(cal.getTime());

 DocumentBuilder builder = new DocumentBuilder(doc);
 builder.insertNode(sdtDate);

 doc.save(getArtifactsDir() + "StructuredDocumentTag.Date.docx");
 

Fields

FieldDescription
DATEThe date value for a date SDT is stored as a date in the standard XML Schema Date format.
DATE_TIMEThe date value for a date SDT is stored as a date in the standard XML Schema DateTime format.
DEFAULTDefaults to DATE_TIME
TEXTThe date value for a date SDT is stored as text.
length

Methods

MethodDescription
fromName(String sdtDateStorageFormatName)
getName(int sdtDateStorageFormat)
getValues()
toString(int sdtDateStorageFormat)

DATE

public static int DATE

The date value for a date SDT is stored as a date in the standard XML Schema Date format.

DATE_TIME

public static int DATE_TIME

The date value for a date SDT is stored as a date in the standard XML Schema DateTime format.

DEFAULT

public static int DEFAULT

Defaults to DATE_TIME

TEXT

public static int TEXT

The date value for a date SDT is stored as text.

length

public static int length

fromName(String sdtDateStorageFormatName)

public static int fromName(String sdtDateStorageFormatName)

Parameters:

ParameterTypeDescription
sdtDateStorageFormatNamejava.lang.String

Returns: int

getName(int sdtDateStorageFormat)

public static String getName(int sdtDateStorageFormat)

Parameters:

ParameterTypeDescription
sdtDateStorageFormatint

Returns: java.lang.String

getValues()

public static int[] getValues()

Returns: int[]

toString(int sdtDateStorageFormat)

public static String toString(int sdtDateStorageFormat)

Parameters:

ParameterTypeDescription
sdtDateStorageFormatint

Returns: java.lang.String