B4A Library [B4X] [XUI] AS DatePicker - fast navigate to a Month - Year - Decade - Century | RangeDatePicker

Alexander Stolte · Apr 18, 2022

This is a simple DatePicker, with which you can quickly reach your target date. With a click on the header the view changes.

I spend a lot of time in creating views, like this and to create a high quality view cost a lot of time. If you want to support me and further views, then you can do it here by Paypal or with a coffee.

In the month view, you can select a date
In the year view, you select a month
In the decade you see a range of 10 years
In century you can see 100 years

SelectMode = Range

Make sure you are using ASViewPager V2.01+
ASDatePicker
Author: Alexander Stolte
Version: 1.17

ASDatePicker_BodyProperties
- Fields:
  - IsInitialized As Boolean
    Tests whether the object has been initialized.
  - TextColor As Int
  - xFont As B4XFont
- Functions:
  - Initialize
    Initializes the fields to their default value.
ASDatePicker_CustomDrawDay
- Fields:
  - BackgroundPanel As B4XView
  - IsInitialized As Boolean
    Tests whether the object has been initialized.
  - xlbl_Date As B4XView
- Functions:
  - Initialize
    Initializes the fields to their default value.
ASDatePicker_HeaderProperties
- Fields:
  - ButtonIconSize As Float
  - Height As Float
  - IsInitialized As Boolean
    Tests whether the object has been initialized.
  - TextColor As Int
  - xFont As B4XFont
- Functions:
  - Initialize
    Initializes the fields to their default value.
ASDatePicker_MonthNameShort
- Fields:
  - April As String
  - August As String
  - December As String
  - February As String
  - IsInitialized As Boolean
    Tests whether the object has been initialized.
  - January As String
  - July As String
  - June As String
  - March As String
  - May As String
  - November As String
  - October As String
  - September As String
- Functions:
  - Initialize
    Initializes the fields to their default value.
ASDatePicker_WeekNameShort
- Fields:
  - Friday As String
  - IsInitialized As Boolean
    Tests whether the object has been initialized.
  - Monday As String
  - Saturday As String
  - Sunday As String
  - Thursday As String
  - Tuesday As String
  - Wednesday As String
- Functions:
  - Initialize
    Initializes the fields to their default value.
ASDatePicker_WeekNumberProperties
- Fields:
  - Color As Int
  - IsInitialized As Boolean
    Tests whether the object has been initialized.
  - Text As String
  - TextColor As Int
  - Width As Float
  - xFont As B4XFont
- Functions:
  - Initialize
    Initializes the fields to their default value.
AS_DatePicker
- Events:
  - CustomDrawDay (Date As Long, Views As ASDatePicker_CustomDrawDay)
  - SelectedDateChanged (Date As Long)
  - SelectedDateRangeChanged (StartDate As Long, EndDate As Long)
- Fields:
  - mBase As B4XView
  - Tag As Object
- Functions:
  - ChangeView (NewView As String)
  - Class_Globals As String
  - CreateASDatePicker_BodyProperties (xFont As B4XFont, TextColor As Int) As ASDatePicker_BodyProperties
  - CreateASDatePicker_HeaderProperties (Height As Float, xFont As B4XFont, TextColor As Int, ButtonIconSize As Float) As ASDatePicker_HeaderProperties
  - CreateASDatePicker_MonthNameShort (January As String, February As String, March As String, April As String, May As String, June As String, July As String, August As String, September As String, October As String, November As String, December As String) As ASDatePicker_MonthNameShort
    <code>AS_DatePicker1.MonthNameShort = AS_DatePicker1.CreateASDatePicker_MonthNameShort("Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sept","Oct","Nov","Dec")</code>
  - CreateASDatePicker_WeekNameShort (Monday As String, Tuesday As String, Wednesday As String, Thursday As String, Friday As String, Saturday As String, Sunday As String) As ASDatePicker_WeekNameShort
    <code>AS_DatePicker1.CreateASDatePicker_WeekNameShort("Mon","Tue","Wed","Thu","Fri","Sat","Sun")</code>
  - CreateASDatePicker_WeekNumberProperties (Width As Float, Color As Int, xFont As B4XFont, TextColor As Int, Text As String) As ASDatePicker_WeekNumberProperties
  - DesignerCreateView (Base As Object, Lbl As Label, Props As Map) As String
    Base type must be Object
  - getBodyColor As Int
  - getBodyProperties As ASDatePicker_BodyProperties
  - getCurrentDateColor As Int
  - getCurrentView_CenturyView As String
  - getCurrentView_DecadeView As String
  - getCurrentView_MonthView As String
  - getCurrentView_YearView As String
  - GetFirstDayOfWeek2 (Ticks As Long, FirstDayOfWeek As Int) As Long
    FirstDayOfWeek:
    Friday = 1
    Thursday = 2
    Wednesday = 3
    Tuesday = 4
    Monday = 5
    Sunday = 6
    Saturday = 7
  - getGridLineColor As Int
  - getHeaderColor As Int
  - getHeaderPanel As B4XView
    You can customize the appereance of the header
    With the following code you can customize the control elements that are visible in the header:
    <code>
    'Middle Text Label
    Dim xlbl_Header As B4XView = AS_DatePicker1.HeaderPanel.GetView(0)
    'Left Arrow Label
    Dim xlbl_ArrowLeft As B4XView = AS_DatePicker1.HeaderPanel.GetView(1)
    'Right Arrow Label
    Dim xlbl_ArrowRight As B4XView = AS_DatePicker1.HeaderPanel.GetView(2)
    </code>
  - getHeaderProperties As ASDatePicker_HeaderProperties
  - getMaxDate As Long
  - getMinDate As Long
  - getMonthNameShort As ASDatePicker_MonthNameShort
    Call Refresh if you change something
    <code>AS_DatePicker1.MonthNameShort = AS_DatePicker1.CreateASDatePicker_MonthNameShort("Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sept","Oct","Nov","Dec")</code>
  - getSelectedDate As Long
  - getSelectedDateColor As Int
  - getSelectedEndDate As Long
    Only in SelectMode "Range"
  - getSelectedStartDate As Long
  - getSelectMode As String
  - getSelectMode_Day As String
  - getSelectMode_Month As String
  - getSelectMode_Range As String
  - getShowGridLines As Boolean
  - getShowWeekNumbers As Boolean
    Gets or sets the number of visible weeks
    Call Refresh to commit changes
  - GetWeekNameByIndex (Index As Int) As String
    1 = Sunday
  - getWeekNameShort As ASDatePicker_WeekNameShort
  - getWeekNumberProperties As ASDatePicker_WeekNumberProperties
    Call Refresh if you change something
    Default Values
    Width: <code>20dip</code>
    Color: <code>xui.Color_ARGB(255,32, 33, 37)</code>
    xFont: <code>xui.CreateDefaultFont(15)</code>
    TextColor: <code>xui.Color_White</code>
  - Initialize (Callback As Object, EventName As String) As String
  - IsInitialized As Boolean
    Tests whether the object has been initialized.
  - Rebuild
    Clears the DatePicker and builds the DatePicker new
  - Refresh As String
  - RefreshHeader As String
    Applies the header properties if any have been changed
  - RefreshSelectedDate As String
  - Scroll2Date (Date As Long) As String
    Scrolls to the date
    Builds the view new if the date was not in range
  - setBodyColor (Color As Int) As String
  - setBodyProperties (BodyProperties As ASDatePicker_BodyProperties) As String
  - setCurrentDateColor (Color As Int) As String
  - setFirstDayOfWeek (number As Int) As String
    1-7
    Friday = 1
    Thursday = 2
    Wednesday = 3
    Tuesday = 4
    Monday = 5
    Sunday = 6
    Saturday = 7
  - setGridLineColor (Color As Int) As String
  - setHeaderColor (Color As Int) As String
  - setHeaderProperties (HeaderProperties As ASDatePicker_HeaderProperties) As String
  - setMaxDate (MaxDate As Long) As String
    Will restrict date navigations features of forward, and also cannot swipe the control using touch gesture beyond the max date range
  - setMinDate (MinDate As Long) As String
    Will restrict date navigations features of backward, also cannot swipe the control using touch gesture beyond the min date range
  - setMonthNameShort (MonthNameShort As ASDatePicker_MonthNameShort) As String
  - setSelectedDate (Date As Long) As String
  - setSelectedDateColor (Color As Int) As String
  - setSelectedEndDate (Date As Long) As String
  - setSelectedStartDate (Date As Long) As String
  - setSelectMode (Mode As String) As String
  - setShowGridLines (Show As Boolean) As String
  - setShowWeekNumbers (Show As Boolean) As String
  - setWeekNameShort (WeekNameShort As ASDatePicker_WeekNameShort) As String
    Call Refresh if you change something
    <code>AS_DatePicker1.CreateASDatePicker_WeekNameShort("Mon","Tue","Wed","Thu","Fri","Sat","Sun")</code>
  - setWeekNumberProperties (WeekNumberProperties As ASDatePicker_WeekNumberProperties) As String
- Properties:
  - BodyColor As Int
  - BodyProperties As ASDatePicker_BodyProperties
  - CurrentDateColor As Int
  - CurrentView_CenturyView As String [read only]
  - CurrentView_DecadeView As String [read only]
  - CurrentView_MonthView As String [read only]
  - CurrentView_YearView As String [read only]
  - FirstDayOfWeek
    1-7
    Friday = 1
    Thursday = 2
    Wednesday = 3
    Tuesday = 4
    Monday = 5
    Sunday = 6
    Saturday = 7
  - GridLineColor As Int
  - HeaderColor As Int
  - HeaderPanel As B4XView [read only]
    You can customize the appereance of the header
    With the following code you can customize the control elements that are visible in the header:
    <code>
    'Middle Text Label
    Dim xlbl_Header As B4XView = AS_DatePicker1.HeaderPanel.GetView(0)
    'Left Arrow Label
    Dim xlbl_ArrowLeft As B4XView = AS_DatePicker1.HeaderPanel.GetView(1)
    'Right Arrow Label
    Dim xlbl_ArrowRight As B4XView = AS_DatePicker1.HeaderPanel.GetView(2)
    </code>
  - HeaderProperties As ASDatePicker_HeaderProperties
  - MaxDate As Long
    Will restrict date navigations features of forward, and also cannot swipe the control using touch gesture beyond the max date range
  - MinDate As Long
    Will restrict date navigations features of backward, also cannot swipe the control using touch gesture beyond the min date range
  - MonthNameShort As ASDatePicker_MonthNameShort
    Call Refresh if you change something
    <code>AS_DatePicker1.MonthNameShort = AS_DatePicker1.CreateASDatePicker_MonthNameShort("Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sept","Oct","Nov","Dec")</code>
  - SelectedDate As Long
  - SelectedDateColor As Int
  - SelectedEndDate As Long
    Only in SelectMode "Range"
  - SelectedStartDate As Long
  - SelectMode As String
  - SelectMode_Day As String [read only]
  - SelectMode_Month As String [read only]
  - SelectMode_Range As String [read only]
  - ShowGridLines As Boolean
  - ShowWeekNumbers As Boolean
    Gets or sets the number of visible weeks
    Call Refresh to commit changes
  - WeekNameShort As ASDatePicker_WeekNameShort
    Call Refresh if you change something
    <code>AS_DatePicker1.CreateASDatePicker_WeekNameShort("Mon","Tue","Wed","Thu","Fri","Sat","Sun")</code>
  - WeekNumberProperties As ASDatePicker_WeekNumberProperties
    Call Refresh if you change something
    Default Values
    Width: <code>20dip</code>
    Color: <code>xui.Color_ARGB(255,32, 33, 37)</code>
    xFont: <code>xui.CreateDefaultFont(15)</code>
    TextColor: <code>xui.Color_White</code>

Changelog

1.00
- Release
1.01
- Add Scroll2Date - Scrolls to the date
- B4J Resize BugFixes
1.02
- BugFixes
- Add designer property InactiveDaysVisible - Displays the days that are not in the current month
  - Default: False
- Add Type ASDatePicker_BodyProperties
  - Font of the Text
  - TextColor of the Text
- The month view now has 6 lines instead of 5
  - It may be that if InactiveDaysVisible = False that an empty line is seen
1.03
- B4J Only - Add Designer Property MouseHoverFeedback
  - Default: True
1.04
- Add Refresh
1.05
- Added a border to the current month, year, or century in the quick navigation
1.06
- Add get and set SelectedDate
- Add Event CustomDrawDay
- Add Type ASDatePicker_CustomDrawDay
1.07
- BugFix
1.08
- Add get and set BodyProperties
- Add get and set HeaderProperties
- Function "Refresh" is now even better
  - No visual flickering
  - Changes are instant
1.09 (read more)
- Add get and set MaxDate - Will restrict date navigations features of forward, and also cannot swipe the control using touch gesture beyond the max date range
- Add get and set MinDate - Will restrict date navigations features of backward, and also cannot swipe the control using touch gesture beyond the max date range
- Add Rebuild - Clears the DatePicker and builds the DatePicker new
1.10 (read more)
- Add Designer property SelectMode -
  - Default: Date
1.11
- BugFixes
1.12
- Add RefreshHeader - Applies the header properties if any have been changed
- New ASDatePicker_HeaderProperties properties
1.13 (read more)
- Add ShowWeekNumbers - Shows the week number for each week
- Add Type ASDatePicker_WeekNumberProperties
1.14 (read more)
- Add Designer Property ShowGridLines
- Add Designer Property GridLineColor
1.15
- Add get and set MonthNameShort
- Add get and set WeekNameShort
1.16
- BugFixes
1.17 (read more)
- Add "Range" to SelectMode
- Add Event SelectedDateRangeChanged
- Debug Mode optimizations
- Add get SelectedStartDate and SelectedEndDate
1.18
- Add compatibility for AS_ViewPager Version 2.0
1.19
- BugFixes
- Add get and set WeekNameProperties
1.20
- BugFixes
1.21
- BugFixes
- Add ArrowsVisible to Type HeaderProperties
1.22
- Big performance improvements
  - The view should now load much faster
1.23
- Add Event PageChanged
1.24
- Add get CurrentView
- Add Event CustomDrawHeader
- BugFixes
1.25
- Add "Height" to ASDatePicker_WeekNameProperties
  - Default: 20dip
- Add "CurrentAndSelectedDayHeight" to ASDatePicker_BodyProperties
  - Default: 30dip
- Add "SelectedTextColor" to ASDatePicker_BodyProperties
  - Default: White
1.26
- Important crash fix
1.27 (read more)
- BugFixes and Improvements
- Add Themes - You can now switch to Light or Dark mode
  - Add set Theme
  - Add get Theme_Dark
  - Add get Theme_Light
- Add Designer Property ThemeChangeTransition
  - Default: Fade

Have Fun

Alexander Stolte · Aug 20, 2022

Update

1.10
- Add Designer property SelectMode -
  - Default: Date
1.11
- BugFixes
1.12
- Add RefreshHeader - Applies the header properties if any have been changed
- New ASDatePicker_HeaderProperties properties

SelectMode - Month
In this mode you do not select a day, but a month.

Alexander Stolte · Oct 21, 2022

Update

1.13
- Add ShowWeekNumbers - Shows the week number for each week
- Add Type ASDatePicker_WeekNumberProperties

Alexander Stolte · Oct 25, 2022

Update

1.14
- Add Designer Property ShowGridLines
- Add Designer Property GridLineColor

Actually only the appointments are missing and then it is a scheduler in the monthly view or?
Look at this beautiful design...how everything fits together

BugNot · Nov 2, 2022

Hi,

How to add an image on a specific day of the calendar?

Thanks

B4X:

Private Sub AS_DatePicker1_CustomDrawDay (Date As Long, Views As ASDatePicker_CustomDrawDay)
    'Color week-end
    If DateTime.GetDayOfWeek(Date) = 7 Then
        Views.xlbl_Date.TextColor = xui.Color_ARGB(255,221, 95, 96)
    else If DateTime.GetDayOfWeek(Date) = 1 Then
        Views.xlbl_Date.TextColor = xui.Color_ARGB(255,221, 95, 96)
    End If


    'Add a image    
    If DateTime.GetDayOfMonth = 7 Then
        Views.xlbl_Date.AddView....'What next for add a image?
    End If

Alexander Stolte · Nov 2, 2022

B4X:

Private Sub AS_DatePicker1_CustomDrawDay (Date As Long, Views As ASDatePicker_CustomDrawDay)
    
    Views.xlbl_Date.Height = 20dip
    
    If DateTime.GetDayOfMonth(Date) = 7 Then
        
        Dim xiv As B4XView = CreateImageView("")
        Views.BackgroundPanel.AddView(xiv,0,Views.xlbl_Date.Height,Views.BackgroundPanel.Width,Views.BackgroundPanel.Height - Views.xlbl_Date.Height)
        xiv.SetBitmap(xui.LoadBitmapResize(File.DirAssets,"tothemoon.png",xiv.Width,xiv.Height,True))
        
    End If
    
End Sub

Private Sub CreateImageView(EventName As String) As B4XView   
    Dim iv As ImageView
    iv.Initialize(EventName)
    Return iv   
End Sub

BugNot · Nov 2, 2022

Alexander Stolte said:

B4X:

Private Sub AS_DatePicker1_CustomDrawDay (Date As Long, Views As ASDatePicker_CustomDrawDay)
   
    Views.xlbl_Date.Height = 20dip
   
    If DateTime.GetDayOfMonth(Date) = 7 Then
       
        Dim xiv As B4XView = CreateImageView("")
        Views.BackgroundPanel.AddView(xiv,0,Views.xlbl_Date.Height,Views.BackgroundPanel.Width,Views.BackgroundPanel.Height - Views.xlbl_Date.Height)
        xiv.SetBitmap(xui.LoadBitmapResize(File.DirAssets,"tothemoon.png",xiv.Width,xiv.Height,True))
       
    End If
   
End Sub

Private Sub CreateImageView(EventName As String) As B4XView  
    Dim iv As ImageView
    iv.Initialize(EventName)
    Return iv  
End Sub

View attachment 135562

many thanks alexander

Maicon · Nov 10, 2022

How to change the language of days?

BugNot · Nov 11, 2022

To try :

B4X:

AS_DatePickerTimeline1.CreateASDatePicker_WeekNameShort("Lun", "Mar", "Mer", "Jeu","Ven", "Sam", "Dim")

Alexander Stolte · Nov 19, 2022

Update

1.15
- Add get and set MonthNameShort
- Add get and set WeekNameShort

Alexander Stolte · Jan 12, 2023

Update

1.16
- BugFixes

Alexander Stolte · Jan 17, 2023

Update

1.17
- Add "Range" to SelectMode
- Add Event SelectedDateRangeChanged
- Debug Mode optimizations
- Add get SelectedStartDate and SelectedEndDate

Daica · Jan 17, 2023

Awesome!

I don't see the method to get the selected ranges from the DatePicker. Am I missing something?
Something like SelectedRange.StartDate and SelectedRange.EndDate

Also, is it not possible to select a single date within "Range" mode?

Alexander Stolte · Jan 17, 2023

Daica said:
I don't see the method to get the selected ranges from the DatePicker. Am I missing something?
Something like SelectedRange.StartDate and SelectedRange.EndDate

There are one new event SelectedDateRangeChanged.

Daica said:
Also, is it not possible to select a single date within "Range" mode?

But the normal SelectedDay event is triggered when only 1 day is selected.

Alexander Stolte · Jan 17, 2023

Daica said:
Something like SelectedRange.StartDate and SelectedRange.EndDate

Download the lib. again, there is now a get SelectedStartDate and SelectedEndDate property.

Daica · Jan 17, 2023

Alexander Stolte said:
Download the lib. again, there is now a get SelectedStartDate and SelectedEndDate property.

The updated version works as expected now. Thank you Alex. Sent you a few $ for some coffee

Alexander Stolte · Jan 17, 2023

Thanks

Daica · Jan 17, 2023

Alexander Stolte said:
Download the lib. again, there is now a get SelectedStartDate and SelectedEndDate property.

Idea/Suggestion:

In future versions could you include ability to manually set the SelectedStartDate and SelectedEndDate so that when the calendar is opened, those dates are selected already?

Alexander Stolte · Jan 18, 2023

Daica said:
ability to manually set the SelectedStartDate and SelectedEndDate so that when the calendar is opened, those dates are selected already?

Download the lib. again, there is now a set SelectedStartDate and SelectedEndDate property.

B4X:

AS_DatePicker1.SelectedStartDate = DateTime.Now
AS_DatePicker1.SelectedEndDate = DateTime.Now + DateTime.TicksPerDay*3

Daica · Jan 27, 2023

Do you think its possible to add a feature where when you're in "Range" mode, you can press and hold down on a date to select a single day?
When a single day is selected maybe it can just return the same date for both start and end date?

Currently in range mode, you have to select 2 different dates, sometimes, people only want to select a single day instead.

Alexander Stolte · Jan 27, 2023

Daica said:
Currently in range mode, you have to select 2 different dates, sometimes, people only want to select a single day instead.

Alexander Stolte said:
But the normal SelectedDay event is triggered when only 1 day is selected.

B4A Library [B4X] [XUI] AS DatePicker - fast navigate to a Month - Year - Decade - Century | RangeDatePicker

Attachments

Expert

Expert

Expert

Member

Expert

Member

Member

Member

Expert

Expert

Expert

Active Member

Expert

Expert

Active Member

Expert

Active Member

Expert

Active Member

Expert

Similar Threads

Privacy & Transparency

Privacy & Transparency