NEWS : Basic Date Picker

TIP: How to determine Assembly Version Number

geoffrey.mcgill — Wed, 28 Feb 2007 07:39:37 GMT

There are several ways to determine the Assembly Version Number, although probably the easiest is opening the controls smart-tag in Visual Studio 2005 design view. The version number is listed in the bottom-right corner. See:

Another way to view the version number is by opening a page in a browser and viewing the HTML source code. The version number is listed just inside the wrapping <span> of the control. Example:

<span id="BasicDatePicker1" class="basicdatepicker"><!-- Version 1.3.5.0.

A third way is to open File Explorer and browse to your projects /Bin/ directory. Select the BasicFrame.WebControls.BasicDatePicker.dll file, then right-click and view "Properties". Under the File version should be listed under the "Version" tab.

Hope this helps.

NEWS: Microsoft AJAX Beta 2.0 Compatibility

geoffrey.mcgill — Fri, 10 Nov 2006 18:20:58 GMT

We've just released a new build which provides full support for the recently released Microsoft AJAX Beta 2.0 release.

Download the latest .NET 2.0 installer from http://www.basicdatepicker.com/download/

Please feel free to contact us if you have any questions or comments and we will do our best to help out.

NEWS: Microsoft AJAX Beta 1.0 support (and Atlas too)

geoffrey.mcgill — Fri, 27 Oct 2006 17:48:30 GMT

We're happy to inform everyone — that to the best of our knowledge — we're the first third party ASP.NET control suite to support the recently released Microsoft AJAX Beta 1.0 release. We've supported the Atlas CTP build for a while, and now we support both.

No need for separate installers and your upgrade path from Atlas to AJAX should be seamless.

Download the latest .NET 2.0 installer from http://www.basicdatepicker.com/download/

Please feel free to contact us if you have any questions or comments and we will do our best to help out.

SAMPLE: Set the MinimumDate client-side.

geoffrey.mcgill — Wed, 20 Sep 2006 17:29:12 GMT

The following sample demonstrates a typical Date Range Selection scenario similar to selecting travel dates.

Two date pickers are linked together so when the StartDate is changed, the EndDate is updated to be 7 days after the selected StartDate. See Sample

The EndDate is updated when the client-side JavaScript function OnClientAfterSelectionChanged is fired.

A DateRangeValidator and DateDifferenceValidator are also used within the sample. The DateRangeValidator checks to ensure the StartDate does not occur in the past and the DateDifferenceValidator checks to ensure the EndDate is at least 7 days greater than the StartDate.

FEATURE: ATLAS Support

geoffrey.mcgill — Fri, 01 Sep 2006 19:38:58 GMT

We've added full support for the Microsoft "Atlas" Framework.

Now you can just drag and drop a Date Picker (or Time Picker) into your atlas UpdatePanel and everything just works.

The following Sample demonstrates how to use the DatePicker and TimePicker within an Atlas UpdatePanel while data binding to GridView and FormView controls. See Sample.

Atlas support has also been extended to the free date picker (BDPLite).

FEATURE: NullDate Property

geoffrey.mcgill — Thu, 27 Jul 2006 20:50:00 GMT

We added a new NullDate property to BasicDatePicker which allows the developer to override what DateTime value is used to represent a 'null' or empty date.

In previous versions DateTime.MinValue was used, and it's still the default value, but it can now be overridden with any DateTime value.

For example, some applications may use DateTime.MaxValue to represent a null or empty value.

[VB]
Me.BasicDatePicker1.NullDate = DateTime.MaxValue

[C#]
this.BasicDatePicker1.NullDate = DateTime.MaxValue;

See also
SelectedValue property

Note: The NullDate property is not available in BDPLite.

FEATURE: SelectedValue property

geoffrey.mcgill — Thu, 27 Jul 2006 20:31:02 GMT

We added a new SelectedValue property to both BasicDatePicker and BDPLite.

The SelectedValue property should help solve problems with auto binding to a DataSource that may contain null or DBNull date values.

The following sample demonstrates using a GridView and SQLDataSource control to bind to the new SelectedValue property. See Sample

To get access to the SelectedValue property you must download and install the latest build.

Please feel free to contact us if you have any questions or comments and we will do our best to help out.

Hope this helps.

SAMPLE: Disable all Sundays and Validate

geoffrey.mcgill — Thu, 13 Jul 2006 22:06:29 GMT

We added another interesting sample which demonstrates how to disable all Sundays within the popup Calendar by using the OnClientDayRender client-side event and use the Microsoft CustomValidator Control to ensure a user did not type in a date that was a Sunday. See Sample.

The SelectableWeekendDays property can be used if you want to disable both weekend days (Saturday & Sunday). Example:

<BDP:BasicDatePicker ID="BasicDatePicker1" runat="server" SelectableWeekendDays="false" />

Hope this helps.

SAMPLE: Using DateCompareValidator to validate Age

geoffrey.mcgill — Thu, 13 Jul 2006 20:37:04 GMT

Tip: Using DateCompareValidator to validate Age

A customer sent us a question on how to validate that an Age was greater than 18 years. We came up with the following simple example to demonstrate the technique.

Step 1: Add a BasicDatePicker and DateCompareValidator to your page and Set the ControlToValidate property. Example:

[HTML/Design View]
<BDP:BasicDatePicker ID="BasicDatePicker1" runat="server" /> <BDP:DateCompareValidator
    ID="AgeCompareValidator"
    runat="server"
    ControlToValidate="BasicDatePicker1"
    ErrorMessage="Must 18 years or older."
    Operator="LessThanEqual">
</BDP:DateCompareValidator>

The key to making this all work is setting the DateToCompare property of the DateCompareValidator to a Date 18 years in the past.

Step 2: Add the following to your code behind (Page_load). Example:

[Visual Basic]
Me.AgeCompareValidator.DateToCompare = DateTime.Today.AddYears(-18)

[C#]
this.AgeCompareValidator.DateToCompare = DateTime.Today.AddYears(-18);

To test the above sample, open the WebForm in a browser and type the following:

1. Within the Date Picker TextBox, type "t-18y" (without quotes), then tab off. The Selected Date will be set to "Today minus 18 years", which will pass the DateCompareValidator.
2. Click inside the TextBox and hit the up-arrow on your keyboard which will add one day to the above date. This new date will fail validation.

Related to the above Age Validation, if you want to Calculate an Age based on a supplied Date, the following Age() Method can be used from your code-behind. Example:

[C#]
/// <summary>
/// Calculates the Age based on a given birth date.
/// </summary>
/// <param name="birthDate">Birth date to calculate age.</param>
/// <returns>Returns the age as an Integer.</returns>
public int Age(DateTime dateOfBirth)
{
    if (DateTime.Today.Month < dateOfBirth.Month || DateTime.Today.Month == dateOfBirth.Month && DateTime.Today.Day < dateOfBirth.Day)
    {
        return DateTime.Today.Year - dateOfBirth.Year - 1;
    }
    else
    {
        return DateTime.Today.Year - dateOfBirth.Year;
    }
}

Hope this helps.

SAMPLE: Using DateDifferenceValidator

geoffrey.mcgill — Thu, 29 Jun 2006 20:24:11 GMT

We've had several questions lately requesting more information about the DateDifferenceValidator, so we put together a simple DateDifferenceValidator sample page with description and code sample. See Sample

The above DateDifferenceValidator sample will be added to the documentation and available on the next build.

Tip: Manually install Component Icons to Visual Studio ToolBox

geoffrey.mcgill — Wed, 28 Jun 2006 19:47:41 GMT

If for some reason the date picker component icons do not get installed to your Visual Studio or Visual Web Developer Express Toolbox when you run the .msi installer, they're easy to install manually. Steps:

Open Visual Studio or Visual Web Developer
Open an .aspx page
Open the ToolBox panel. Typically located on the left side in a fly-out panel (Ctrl + Alt + x).
If a "Basic Date Picker" Tab has already been created, click to slide open. If the "Basic Date Picker" Tab was not created during the installation process, you can create now.

Right-Click in the ToolBox area.
Select "Add Tab".
Enter "Basic Date Picker".

Inside the "Basic Date Picker" tab, Right-Click and select "Choose Item..." ("Add/Remove Items..." in Visual Studio .NET 2003).
Under the ".NET Framework Components" Tab select the "Browse" button.
Navigate to and select the following .dll file on your file system, choose open.

NOTE:

The component items should be added to the list and pre-checked. You can confirm by sorting the list by "Namespace" and scrolling to "BasicFrame.WebControls"
Click "OK". The icons should be added to your ToolBox. You should now be able to drag/drop a date picker onto your WebForm.

NOTE: You can also drag and drop the icons between tabs to reorder if desired.

Hope this helps.

Tip: How to change the size of the TextBox?

geoffrey.mcgill — Tue, 27 Jun 2006 22:12:28 GMT

We added another Q&A to our list of Top Support Questions which details several techniques for changing the size of the TextBox. See http://www.basicdatepicker.com/support/#q5

Our favorite is probably Option #3. A straightforward CSS edit that we add to our global .css file and the style is picked up application wide by all date pickers. eazy peazy. No source code (.aspx/code-behind) edits is also a bonus.

Resource: Listing all .NET supported Cultures

geoffrey.mcgill — Thu, 22 Jun 2006 23:51:11 GMT

We created a sample page demonstrating how to output a list all the .NET supported Cultures. The list details several properties of the CultureInfo object including the Date and Time Formats as well as sample output for each.

EnglishName
Abbreviation
ShortDate Format + example
LongDate Format + example
ShortTime Format + example
LongTime Format + example

The sample also demonstrates how to sort a list of Cultures by creating a custom IComparer Class and comparing the EnglishName strings.

The C# code used in this example is available at the bottom of the table.

See Sample

See also
Standard DateTime Format Strings | Custom DateTime Format Strings