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

# widget\_dateentry(3tk)

Date Entry Megawidget

```

```

## NAME

widget\_dateentry - Date Entry Megawidget

## SYNOPSIS

package require **Tcl 8.4**

package require **Tk 8.4**

package require **widget ?3.0?**

package require **widget::dateentry ?0.98?**

**widget::dateentry** *pathname* ?options?

*pathname* **get**

*pathname* **set** *date*

```

```

## DESCRIPTION

This package provides a dateentry megawidget (snidget). It is based on an ttk::entry. All widget commands of the ttk::entry are available for the dateentry.

- **widget::dateentry** *pathname* ?options?

  ## WIDGET OPTIONS

- **-command**

  A command prefix to evaluate when a date was selected. The command prefix is executed in the global namespace and given two arguments, the raw date in seconds, and the formatted date, as per option **-dateformat**.

- **-dateformat**

  The format of the date that is entered or returned. Default: %m/%d/%Y.

- **-firstday**

  See the **widget::calendar** man page.

- **-font**

  Select the font used in the widget. It defaults to Helvetica 9.

- **-highlightcolor**

  See the **widget::calendar** man page. See the calendar man page.

- **-language**

  See the **widget::calendar** man page.

- **-shadecolor**

  See the **widget::calendar** man page.

- **-showpast**

  See the **widget::calendar** man page.

- **-textvariable**

  Specifies the name of a variable whose value is linked to the entry widget's contents. Whenever the variable changes value, the widget's contents are updated, and vice versa.

## WIDGET COMMAND

- *pathname* **get**

  Returns the selected date.

- *pathname* **set** *date*

  Programmatically sets a new date. Expects that the date is in the same format as configured by option **-dateformat**.

  The same effect can also be achieved by setting a linked **-textvariable**.

## DEFAULT BINDINGS

On creation of the dateentry widget the following bindings are installed. For navigation within the calendar, see its manpage.

- •

  Button-1 - Accept and select the date and close the calendar window.

- •

  Return, space - Accept the selected date and close the calendar window

- •

  Escape - Close calendar window

- •

  Control-space - Show calendar window

## EXAMPLE

```
    package require widget::dateentry; # or widget::all
    set t [widget::dateentry .de]
    pack $t -fill x -expand 1
```

## BUGS, IDEAS, FEEDBACK

This document, and the package it describes, will undoubtedly contain bugs and other problems. Please report such in the category *widget::dateentry* 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.

## KEYWORDS

date, dateentry, megawidget, snit, widget

## CATEGORY

Widget