날짜 및 시간 필드

이 가이드는 Aspose.Words FOSS for .NET에서 캘린더 인식 날짜 및 시간 필드 클래스를 사용하는 방법을 보여줍니다 — FieldDate, FieldCreateDate, FieldPrintDate, 및 FieldSaveDate — Word의 구현 DATE, CREATEDATE, PRINTDATE, 및 SAVEDATE 필드를 각각 구현합니다. 각 클래스는 Field 및 구현합니다 IFieldWithCalendar; 기본 Field 객체 모델 자체(업데이트, 연결 해제, 제거 및 모든 필드 형식 지정), 자세히 보려면 필드 작업 가이드.

네 개의 날짜 및 시간 필드 클래스

FieldDate은(는) DATE 필드를 구현합니다. FieldCreateDate은(는) CREATEDATE을 구현하며, 이는 문서가 생성된 날짜입니다. FieldPrintDate은(는) PRINTDATE을 구현하고, 이는 문서가 마지막으로 인쇄된 날짜입니다. FieldSaveDate은(는) SAVEDATE을 구현하며, 이는 문서가 마지막으로 저장된 날짜입니다. 네 개 모두는 Field의 하위 클래스이며 IFieldCodeTokenInfoProvider와 IFieldWithCalendar을 구현하므로, 아래에 설명된 자체 캘린더 스위치와 함께 Field의 GetFieldCode(), Update(), Unlink(), Remove() 및 서식(Format) 멤버를 공유합니다.

그레고리안이 아닌 캘린더 선택

네 클래스 각각은 Hijri Lunar 또는 Hebrew Lunar 캘린더를 사용해 결과를 표시하기 위한 UseLunarCalendar (bool), Saka Era 캘린더를 위한 UseSakaEraCalendar (bool), 그리고 Um-al-Qura 캘린더를 위한 UseUmAlQuraCalendar (bool)를 노출합니다. 해당 속성을 true으로 설정한 후 Update()를 호출하면, 필드가 기본 그레고리안 캘린더 대신 해당 캘린더 시스템을 사용해 결과를 다시 계산합니다.

FieldDate의 Application-Format 스위치

FieldDate은(는) 추가로 UseLastFormat (bool)을 노출합니다. 이는 새 DATE 필드가 삽입될 때 호스팅 애플리케이션이 마지막으로 사용한 형식을 필드가 사용할지 여부를 제어합니다. FieldCreateDate, FieldPrintDate, FieldSaveDate는 이 속성을 노출하지 않습니다.

팁 및 모범 사례

캘린더 스위치(UseLunarCalendar, UseSakaEraCalendar, 또는 UseUmAlQuraCalendar)를 설정한 다음 필드에 대해 Update()을 호출하십시오 — 속성만 변경해도 Result가 다시 계산되지 않습니다.
특정 필드 인스턴스에서는 하나의 캘린더 스위치만 true으로 설정하십시오; 둘 이상을 결합하면 모호한 결과가 발생합니다.
사용 Field.Format (a FieldFormat, 에서 다루는 필드 결과 형식 지정 가이드)와 이러한 캘린더 스위치를 함께 사용하여 결과에 적용되는 숫자 또는 날짜/시간 형식 그림을 제어합니다.
필요한 의미에 맞는 클래스를 선택하십시오 — FieldSaveDate과 FieldPrintDate은 문서에 기록된 타임스탬프를 읽고, FieldDate는 필드가 업데이트된 날짜를 반영합니다.

일반적인 문제

문제	원인	수정
캘린더 스위치를 전환해도 표시된 결과에 영향을 주지 않습니다	속성을 설정한 후 필드가 다시 계산되지 않았습니다	`UseLunarCalendar`, `UseSakaEraCalendar`, 또는 `UseUmAlQuraCalendar`를 설정한 후 필드 인스턴스에서 `Update()`을 호출하십시오
`UseLastFormat`은(는) `FieldPrintDate` 또는 `FieldSaveDate`에서 컴파일되지 않습니다	해당 속성은 `FieldDate`에만 존재합니다	application-format-follows 동작을 위해 `FieldDate`을 사용하거나, 다른 클래스에서 `Format`을 명시적으로 설정하십시오
결과에 잘못된 달력 시스템이 표시됩니다	같은 필드에 `true` 로 설정된 달력 스위치가 두 개 이상 지정되었습니다	필드 인스턴스당 `UseLunarCalendar`, `UseSakaEraCalendar`, `UseUmAlQuraCalendar` 중 하나만 설정하십시오

FAQ

FieldDate와 FieldCreateDate의 차이점은 무엇인가요?

FieldDate은 DATE 필드를 구현합니다(업데이트될 때마다 현재 날짜로 다시 계산됨); FieldCreateDate은 CREATEDATE을 구현합니다(문서가 생성된 날짜).

날짜 필드가 Hijri Lunar calendar를 사용하도록 하려면 어떻게 해야 하나요?

UseLunarCalendar = true을 FieldDate, FieldCreateDate, FieldPrintDate 또는 FieldSaveDate 인스턴스에 설정한 다음 Update()를 호출하십시오.

네 개의 클래스 중 어느 것이 문서가 마지막으로 저장된 시점을 추적합니까?

FieldSaveDate은 SAVEDATE 필드를 구현합니다.

이 클래스들은 캘린더 전환뿐만 아니라 사용자 정의 포맷 이미지도 지원합니까?

예 — 각각은 a 를 노출합니다 Format 속성 (FieldFormat) 기본 필드 인프라에서 상속됨; 자세한 내용은 필드 결과 포맷팅 에 대한 가이드 NumericFormat and DateTimeFormat.

API Reference 요약

클래스/메서드	설명
`FieldDate`	다음 `DATE` 필드를 구현합니다
`FieldCreateDate`	`CREATEDATE` 필드를 구현합니다
`FieldPrintDate`	`PRINTDATE` 필드를 구현합니다
`FieldSaveDate`	`SAVEDATE` 필드를 구현합니다
`UseLunarCalendar`	Hijri Lunar 또는 Hebrew Lunar 달력을 사용하여 결과를 렌더링합니다
`UseSakaEraCalendar`	Saka Era 달력을 사용하여 결과를 렌더링합니다
`UseUmAlQuraCalendar`	Um-al-Qura 달력을 사용하여 결과를 렌더링합니다
`FieldDate.UseLastFormat`	호스팅 애플리케이션에서 마지막으로 사용한 형식을 새로운 `DATE` 필드에 사용합니다
`IFieldWithCalendar`	캘린더 인식 필드 결과를 위해 네 개 클래스가 모두 구현한 인터페이스

참조

Aspose.Words for .NET — Enterprise Documentation