---
name: "datefield"
section: "3tk"
platform: "linux"
package: "tklib"
version: "0.9-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/datefield/3tk"
---

# datefield(3tk)

Tk datefield widget

```

```

## NAME

datefield - Tk datefield widget

## SYNOPSIS

package require **Tk**

package require **datefield ?0.3?**

**::datefield::datefield** *widgetpath* ?*options*?

*-format*

```

```

## DESCRIPTION

The **datefield** package provides the datefield widget which is an enhanced text entry widget for the purpose of date entry. There are three valid formats for the dates which can be entered:

- \[1\]

  English form MM/DD/YYYY using *-format "%m/%d/%Y"* (default)

- \[2\]

  German form DD.MM.YYYY using *-format "%d.%m.%Y"*

- \[3\]

  ISO form YYYY-MM-DD using *-format "%Y-%m-%d"*

The datefield widget is, in fact, just an entry widget with specialized bindings. This means all the command and options for an entry widget apply equally here.

## COMMANDS

- **::datefield::datefield** *widgetpath* ?*options*?

  Creates and configures a date field widget.

## OPTIONS

- *-format*

  One of "%m/%d/%Y" (English, default if option left), "%d.%m.%Y" (German), or "%Y-%m-%d" (ISO).

See the **entry** manual entry for details on all remaining/available options.

## EXAMPLE

```
 package require datefield
 wm title . "Datefield example"
 proc DayOfWeek {args} {
     set now [clock scan $::myDate]
     set ::myDate2 [clock format $now -format %A]
 }
 trace variable myDate w DayOfWeek
 ::datefield::datefield .df -textvariable myDate -format "%m/%d/%Y"
 label .l1 -text "Enter a date:"   -anchor e
 label .l2 -text "That date is a:" -anchor e
 label .l3 -textvariable myDate2 -relief sunken -width 12
 grid .l1 .df -sticky ew
 grid .l2 .l3 -sticky ew
 focus .df
```

## BUGS, IDEAS, FEEDBACK

This document, and the package it describes, will undoubtedly contain bugs and other problems. Please report such in the category *datefield* of the *Tklib Trackers* \[http://core.tcl.tk/tklib/reportlist\]. Please also report any ideas for enhancements you may have for either package and/or documentation.

## SEE ALSO

[clock(3tcl)](/clock/3tcl.md), [entry(3tk)](/entry/3tk.md)

## KEYWORDS

clock, date, dateentry, entry, widget

## CATEGORY

Widget

## COPYRIGHT

```
Copyright (c) Keith Vetter <keith@ebook.gemstar.com>
Copyright (c) Thomas Wunderlich <tcl.tk@blindenfreizeiten.de>
```