tqt3/doc/y2k.doc

/****************************************************************************
**
** TQt Year 2000 Compliance
**
** Copyright (C) 1992-2008 Trolltech ASA.  All rights reserved.
**
** This file is part of the TQt GUI Toolkit.
**
** This file may be used under the terms of the GNU General
** Public License versions 2.0 or 3.0 as published by the Free
** Software Foundation and appearing in the files LICENSE.GPL2
** and LICENSE.GPL3 included in the packaging of this file.
** Alternatively you may (at your option) use any later version
** of the GNU General Public License if such license has been
** publicly approved by Trolltech ASA (or its successors, if any)
** and the KDE Free TQt Foundation.
**
** Please review the following information to ensure GNU General
** Public Licensing requirements will be met:
** http://trolltech.com/products/qt/licenses/licensing/opensource/.
** If you are unsure which license is appropriate for your use, please
** review the following information:
** http://trolltech.com/products/qt/licenses/licensing/licensingoverview
** or contact the sales department at sales@trolltech.com.
**
** This file may be used under the terms of the Q Public License as
** defined by Trolltech ASA and appearing in the file LICENSE.QPL
** included in the packaging of this file.  Licensees holding valid Qt
** Commercial licenses may use this file in accordance with the Qt
** Commercial License Agreement provided with the Software.
**
** This file is provided "AS IS" with NO WARRANTY OF ANY KIND,
** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted
** herein.
**
**********************************************************************/

/*! \page y2k.html

\title Year 2000 Compliance Statement

Trolltech defines <i>Year 2000 Compliance</i> as a requirement that a
product or part of product does not contain errors related to
transition from December 31, 1999 to January 1, 2000, or to the
existence of February 29, 2000.

This document certifies that the API provided by TQt and the
implementation of TQt are both Year 2000 Compliant, and that the use of
underlying APIs by TQt does not have any known problems.

\section1 The API Provided by Qt

Several parts of TQt deal with dates and times:
\list
\i \l TQDate - provides date management
\i \l TQDateTime - provides date/time management
\i \l TQTime - provides time management (within a date)
\i \l TQTimer - provides delayed or regular execution of code.
\endlist

All of these classes' external APIs are Year 2000 Compliant: TQDate and
TQDateTime offer only four-digit years as output, TQTime and TQTimer do
not deal with years or leap days at all.

\section1 Implementation Issues in Qt

All date/time calculation and storage in TQt uses number of days,
seconds or milliseconds, and is thus Year 2000 Compliant.

This applies to the above four classes and also to \l TQFileDialog
(which can sort files by time/date), \l TQFileInfo (which operates on
file times/dates) and \l TQApplication (which does various internal
housekeeping tasks).

The conversion to <tt>year/month/date</tt> format in TQDate (and
TQDateTime) has been verified to be correct for all of December 31,
1999, January 1, 2000, February 28 and 29, 2000, March 1, 2000,
January 1, 2001 and March 1, 2001.

Qt has been verified to be robust in case of time/date errors (such as
time warps) in the underlying operating system.

\section1 Use of System APIs

It is of course impossible for Trolltech to ensure that both of the
window systems and all of the operating systems on which TQt runs are
Year 2000 Compliant. However, TQt does not use any APIs that are known
to have any Year 2000-related bugs, or seem at risk to have any.
*/