Field formatter for a date time field. More...

#include <qgsdatetimefieldformatter.h>

Inheritance diagram for QgsDateTimeFieldFormatter:

Public Member Functions
	QgsDateTimeFieldFormatter ()=default
	Date time display format is localized by applyLocaleChange.

QString	id () const override
	Returns a unique id for this field formatter.

QString	representValue (QgsVectorLayer *layer, int fieldIndex, const QVariantMap &config, const QVariant &cache, const QVariant &value) const override
	Create a pretty String representation of the value.

Public Member Functions inherited from QgsFieldFormatter
	QgsFieldFormatter ()=default

virtual	~QgsFieldFormatter ()=default

virtual Qt::AlignmentFlag	alignmentFlag (QgsVectorLayer *layer, int fieldIndex, const QVariantMap &config) const
	Returns the alignment for a particular field.

virtual QVariantList	availableValues (const QVariantMap &config, int countLimit, const QgsFieldFormatterContext &context) const
	Returns a list of the values that would be possible to select with this widget type On a RelationReference that would be the parents ids or on ValueMap all the configured keys according to the settings in the config.

virtual QVariant	createCache (QgsVectorLayer *layer, int fieldIndex, const QVariantMap &config) const
	Create a cache for a given field.

Flags	flags () const
	Returns the flags.

virtual QList< QgsVectorLayerRef >	layerDependencies (const QVariantMap &config) const SIP_SKIP
	Returns a list of weak layer references to other layers required by this formatter for the given config.

void	setFlags (const Flags &flags)
	Sets the flags.

enum Flag	SIP_ENUM_BASETYPE (IntFlag)
	Flags for the abilities of the formatter.

virtual QVariant	sortValue (QgsVectorLayer *layer, int fieldIndex, const QVariantMap &config, const QVariant &cache, const QVariant &value) const
	If the default sort order should be overwritten for this widget, you can transform the value in here.

Static Public Member Functions
static void	applyLocaleChange ()
	Adjusts the date time display formats according to locale.

static QString	defaultDisplayFormat (QMetaType::Type type)
	Gets the default display format in function of the type.

static Q_DECL_DEPRECATED QString	defaultDisplayFormat (QVariant::Type type) SIP_DEPRECATED
	Gets the default display format in function of the type.

static QString	defaultFormat (QMetaType::Type type)
	Gets the default format in function of the type.

static Q_DECL_DEPRECATED QString	defaultFormat (QVariant::Type type) SIP_DEPRECATED
	Gets the default format in function of the type.

Public Attributes
	SIP_SKIP

Static Public Attributes
static QString	DATE_DISPLAY_FORMAT = QStringLiteral( "yyyy-MM-dd" )

static const QString	DATE_FORMAT = QStringLiteral( "yyyy-MM-dd" )

static QString	DATETIME_DISPLAY_FORMAT = QStringLiteral( "yyyy-MM-dd HH:mm:ss" )
	Date display format is localized by applyLocaleChange.

static const QString	DATETIME_FORMAT = QStringLiteral( "yyyy-MM-dd HH:mm:ss" )

static const QString	DISPLAY_FOR_ISO_FORMAT = QStringLiteral( "yyyy-MM-dd HH:mm:ss+t" )

static const QString	QT_ISO_FORMAT = QStringLiteral( "Qt ISO Date" )
	Date time format was localized by applyLocaleChange before QGIS 3.30.

static const QString	TIME_FORMAT = QStringLiteral( "HH:mm:ss" )
	Date format was localized by applyLocaleChange before QGIS 3.30.

Additional Inherited Members
Public Types inherited from QgsFieldFormatter
typedef QFlags< Flag >	Flags

Detailed Description

Field formatter for a date time field.

This represents a date, time or datetime value based on the field configuration.

Definition at line 30 of file qgsdatetimefieldformatter.h.

Constructor & Destructor Documentation

◆ QgsDateTimeFieldFormatter()

QgsDateTimeFieldFormatter::QgsDateTimeFieldFormatter ( )

default

Date time display format is localized by applyLocaleChange.

See also: applyLocaleChange

Since: QGIS 3.30

Member Function Documentation

◆ applyLocaleChange()

void QgsDateTimeFieldFormatter::applyLocaleChange ( )

static

Adjusts the date time display formats according to locale.

Before QGIS 3.30, the date time formats was adjusted.

Since: QGIS 3.22.2

Definition at line 150 of file qgsdatetimefieldformatter.cpp.

◆ defaultDisplayFormat() [1/2]

QString QgsDateTimeFieldFormatter::defaultDisplayFormat ( QMetaType::Type type )

static

Gets the default display format in function of the type.

The type is expected to be one of

QVariant::DateTime
QVariant::Date
QVariant::Time

Since: QGIS 3.30

Definition at line 132 of file qgsdatetimefieldformatter.cpp.

◆ defaultDisplayFormat() [2/2]

QString QgsDateTimeFieldFormatter::defaultDisplayFormat ( QVariant::Type type )

static

Gets the default display format in function of the type.

The type is expected to be one of

QVariant::DateTime
QVariant::Date
QVariant::Time

Since: QGIS 3.30

Deprecated:: QGIS 3.38. Use the method with a QMetaType::Type argument instead.

Definition at line 145 of file qgsdatetimefieldformatter.cpp.

◆ defaultFormat() [1/2]

QString QgsDateTimeFieldFormatter::defaultFormat ( QMetaType::Type type )

static

Gets the default format in function of the type.

The type is expected to be one of

QVariant::DateTime
QVariant::Date
QVariant::Time

Definition at line 113 of file qgsdatetimefieldformatter.cpp.

◆ defaultFormat() [2/2]

QString QgsDateTimeFieldFormatter::defaultFormat ( QVariant::Type type )

static

Gets the default format in function of the type.

The type is expected to be one of

QVariant::DateTime
QVariant::Date
QVariant::Time

Deprecated:
QGIS 3.38. Use the method with a QMetaType::Type argument instead.

Definition at line 126 of file qgsdatetimefieldformatter.cpp.

◆ id()

QString QgsDateTimeFieldFormatter::id ( ) const

overridevirtual

Returns a unique id for this field formatter.

This id will later be used to identify this field formatter in the registry with QgsFieldFormatterRegistry::fieldFormatter().

This id matches the id of a QgsEditorWidgetFactory.

Implements QgsFieldFormatter.

Definition at line 35 of file qgsdatetimefieldformatter.cpp.

◆ representValue()

QString QgsDateTimeFieldFormatter::representValue	(	QgsVectorLayer *	layer,
		int	fieldIndex,
		const QVariantMap &	config,
		const QVariant &	cache,
		const QVariant &	value
	)		const

overridevirtual

Create a pretty String representation of the value.

Returns: By default the string representation of the provided value as implied by the field definition is returned.

Reimplemented from QgsFieldFormatter.

Definition at line 40 of file qgsdatetimefieldformatter.cpp.

Member Data Documentation

◆ DATE_DISPLAY_FORMAT

QString QgsDateTimeFieldFormatter::DATE_DISPLAY_FORMAT = QStringLiteral( "yyyy-MM-dd" )

static

Definition at line 38 of file qgsdatetimefieldformatter.h.

◆ DATE_FORMAT

const QString QgsDateTimeFieldFormatter::DATE_FORMAT = QStringLiteral( "yyyy-MM-dd" )

static

Definition at line 33 of file qgsdatetimefieldformatter.h.

◆ DATETIME_DISPLAY_FORMAT

QString QgsDateTimeFieldFormatter::DATETIME_DISPLAY_FORMAT = QStringLiteral( "yyyy-MM-dd HH:mm:ss" )

static

Date display format is localized by applyLocaleChange.

See also: applyLocaleChange

Since: QGIS 3.30

Definition at line 39 of file qgsdatetimefieldformatter.h.

◆ DATETIME_FORMAT

const QString QgsDateTimeFieldFormatter::DATETIME_FORMAT = QStringLiteral( "yyyy-MM-dd HH:mm:ss" )

static

Definition at line 35 of file qgsdatetimefieldformatter.h.

◆ DISPLAY_FOR_ISO_FORMAT

const QString QgsDateTimeFieldFormatter::DISPLAY_FOR_ISO_FORMAT = QStringLiteral( "yyyy-MM-dd HH:mm:ss+t" )

static

Definition at line 37 of file qgsdatetimefieldformatter.h.

◆ QT_ISO_FORMAT

const QString QgsDateTimeFieldFormatter::QT_ISO_FORMAT = QStringLiteral( "Qt ISO Date" )

static

Date time format was localized by applyLocaleChange before QGIS 3.30.

Definition at line 36 of file qgsdatetimefieldformatter.h.

◆ SIP_SKIP

QgsDateTimeFieldFormatter::SIP_SKIP

Definition at line 100 of file qgsdatetimefieldformatter.h.

◆ TIME_FORMAT

const QString QgsDateTimeFieldFormatter::TIME_FORMAT = QStringLiteral( "HH:mm:ss" )

static

Date format was localized by applyLocaleChange before QGIS 3.30.

Definition at line 34 of file qgsdatetimefieldformatter.h.

The documentation for this class was generated from the following files:

/build/qgis-3.41.0+git20241110+fda2aa46e9a+99sid/src/core/fieldformatter/qgsdatetimefieldformatter.h
/build/qgis-3.41.0+git20241110+fda2aa46e9a+99sid/src/core/fieldformatter/qgsdatetimefieldformatter.cpp

Public Member Functions

Static Public Member Functions

Public Attributes

Static Public Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ QgsDateTimeFieldFormatter()

Member Function Documentation

◆ applyLocaleChange()

◆ defaultDisplayFormat() [1/2]

◆ defaultDisplayFormat() [2/2]

◆ defaultFormat() [1/2]

◆ defaultFormat() [2/2]

◆ id()

◆ representValue()

Member Data Documentation

◆ DATE_DISPLAY_FORMAT

◆ DATE_FORMAT

◆ DATETIME_DISPLAY_FORMAT

◆ DATETIME_FORMAT

◆ DISPLAY_FOR_ISO_FORMAT

◆ QT_ISO_FORMAT

◆ SIP_SKIP

◆ TIME_FORMAT