|
|
|
|
|
|
|
Chapters 1 through 5 are introductory material, which lay foundations for later work. Chapter 2 introduces some basic concepts of time and dates, which govern decisions and trade-offs throughout the system. Chapter 3 introduces the data structures used to implement the basic system. Chapter 4 introduces the basic header files used. |
|
|
|
|
|
|
|
|
Chapters 5 through 8 deal with the actual functions used for the "Western" calendar and most date/time applications. In particular, Chapter 5 introduces all of the basic functions for dates and time in the Western calendar, and Chapter 6 discusses specific Western calendar dates. Together, these two chapters are the "meat" of the book for a reader who simply wants results and is focused on the Western calendar. Chapter 7 discusses the special topic of proleptic calendars in the context of the Western calendar. Chapter 8 introduces the essential data structures and functions used for working with ISO date/time applications. |
|
|
|
|
|
|
|
|
Chapter 9 is a single chapter, divided into multiple parts, which treats a large number of major calendars. |
|
|
|
|
|
|
|
|
Appendices AG contain auxiliary material for the book, such as concordances, cross-references, a bibliography, glossary, explanation of the DLLs on the companion CD, and so on. |
|
|
|
|
|
|
|
|
An index completes the printed book. |
|
|
|
|
|
|
|
|
The Standard C Date/Time Library is much too extensive to print all of the program code and all of the function descriptions in an affordable book. I have printed only the core processes of SCDTL and the explanations and historic backgrounds for the many specific calendars. The companion CD-ROM contains the entire text of SCDTL, both program code and explanations, including many sections of calendar details that are not in the printed book. A more detailed Table of Contents for the text on the CD is found in the first text chapter, in file ch_01.txt. |
|
|
|
|
|
|
|
|
The SCDTL source code is also provided separately on the CD, with each of the fifty header files and the 462 functions residing in its own file. Use the concordances in Appendix A to cross reference function names with filenames. |
|
|
|
|
|
|
|
|
The companion CD also includes a dynamic link library (SCDTL.DLL), developed by Dan Bock for Windows 95 and Windows NT, compiled using Visual C++ v4.0. This DLL can be called like any other Windows API from development environments such as Visual C++, Visual Basic, and Delphi. Also included are the function declaration modules for Visual Basic. |
|
|
|
|
|
|
|
|
Finally, the CD provides the extensive tests and test output from the Date/Time Library Test series (DTLT) described in Appendix C. |
|
|
|
|
|