MxDateTime - Date/Time Library for Python

mxDateTime

Date/Time Library for Python

Version 3.1

Copyright 1997-2000 by IKDS Marc-Andr? Lemburg, Langenfeld Copyright 2000-2008 by GmbH, Langenfeld

All rights reserved. No part of this work may be reproduced or used in a any form or by any means without written permission of the publisher.

All product names and logos are trademarks of their respective owners. The product names "mxBeeBase", "mxCGIPython", "mxCounter", "mxCrypto", "mxDateTime", "mxHTMLTools", "mxLicenseManager", "mxLog", "mxNumber", "mxODBC", "mxObjectStore", "mxProxy", "mxQueue", "mxStack", "mxTextTools", "mxTidy", "mxTools", "mxUID", "mxURL", "mxXMLTools", "eGenix Application Server", "PythonHTML", "eGenix" and "" and corresponding logos are trademarks of GmbH, Langenfeld.

Printed in Germany.

Contents

Contents

1. Introduction .................................................................................................. 1

2. Design........................................................................................................... 2 2.1 Time Zones, Daylight Savings Time (DST) and Leap Seconds ................ 3 2.2 Calendars .............................................................................................. 3 2.3 Conversion from and to other formats................................................... 4 2.4 Rounding Errors and Roundtrip-Safety ................................................... 4 2.5 Immutability .......................................................................................... 4 2.6 UTC and GMT ....................................................................................... 5 2.7 Interaction with other Types .................................................................. 5 2.8 String formats........................................................................................ 5 2.9 Speed and Memory ............................................................................... 6 2.10 Background and Resource Information on the Web............................... 6

3. mx.DateTime.DateTime Object...................................................................... 7 3.1 DateTime Object Constructors .............................................................. 7 3.2 DateTime Object Methods .................................................................. 11 3.3 DateTime Object Attributes ................................................................. 13

4. mx.DateTime.DateTimeDelta Object ............................................................16 4.1 DateTimeDelta Object Constructors.................................................... 16 4.2 DateTimeDelta Object Methods .......................................................... 17 4.3 DateTimeDelta Object Attributes......................................................... 18

5. mx.DateTime.RelativeDateTime Object.........................................................19 5.1 RelativeDateTime Constructors ........................................................... 19 5.2 RelativeDateTime Object Methods ...................................................... 21 5.3 RelativeDateTime Object Attributes..................................................... 21

mxDateTime - Date/Time Library for Python

5.4 RelativeDateTime Object Usage........................................................... 21

6. mx.DateTime Functions ............................................................................... 24

7. mx.DateTime Constants............................................................................... 25

8. Date/Time Arithmetic................................................................................... 27 8.1 Notes:.................................................................................................. 31

9. mxDateTime Submodules ............................................................................ 32 9.1 mx.DateTime.ISO Submodule.............................................................. 32 9.1.1 Constructors & Functions .......................................................... 32 Notes......................................................................................... 34 9.1.2 ISO 8601 string formats and DateTime[Delta] instances ........... 34 9.2 mx.DateTime.ARPA Submodule ........................................................... 35 9.2.1 Constructors & Functions .......................................................... 35 Notes......................................................................................... 36 9.3 mx.DateTime.Feasts Submodule.......................................................... 36 9.3.1 Constructors & Functions .......................................................... 36 9.4 mx.DateTime.Parser Submodule.......................................................... 37 9.4.1 Constructors & Functions .......................................................... 38 9.5 mx.DateTime.NIST Submodule ............................................................ 40 9.5.1 Constructors & Functions .......................................................... 40 9.5.2 Constants .................................................................................. 42 9.5.3 Examples ................................................................................... 43

10. Examples of Use .......................................................................................... 44

11. mx.DateTime Python C-API.......................................................................... 45

12. mxDateTime Package Structure.................................................................... 46

13. Support ....................................................................................................... 47

14. Copyright & License .................................................................................... 48

1. Introduction

1. Introduction

The mxDateTime package provides consistent way of transferring date and time data between Python and databases. Apart from handling dates before the Unix epoch (1.1.1970) they also correctly work with dates beyond the Unix time limit (currently with Unix time values being commonly encoded using 32bit integers, the limit is reached in 2038) and thus is Year 2000 and Year 2038 safe. The package provides three main data structures for working with date and time values. These are:

? DateTime for referring to absolute date/time values, ? DateTimeDelta for date/time spans and ? RelativeDateTime for representing variable date/time spans (these

are the TABs of date/time calculation) All object, functions and constants are available via the package namespace mx.DateTime.

1

 ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download